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1  INTRODUCTION 

This  document  describes  the  operating  system  software  of  the 
multiprocessor  Improved  Packet  Radio  unit  (1PR).  It  is  intended  as  a 
users  guide  for  operation  of  the  IPR  and  as  an  operating  system 
interface  specification  for  developers  of  IPk  system  software. 

This  document  consists  of  four  major  sections.  Section 
2  provides  an  overview  description  of  the  IPR  digital  unit 
hardware.  Section  3  describes  the  operating  system  software. 

Section  4  defines  the  structure  and  organization  of  the  IPR 

user  processes  (jobs)  and  user  process  interfaces  to  the  operating 

system  software.  Section  b  describes  IPR  operating 

procedures.  This  document,  together  with  the  separate  specifications  of 

the  IPk  user  processes,  provides  a  comprehensive  description  of  the  IPR 

system  software. 

Throughout  this  document,  the  most  significant  (left-most)  bit  of 
each  word  is  numbered  U  while  the  least  significant  (right-most)  bit  is 
numbered  lb.  This  is  the  numbering  convention  adopted  by  Texas 
Instruments. 
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2  HARDWARE  ARCHITECTURE 


it  ,n^e“e  co"f1^rat1on  of  the  IPR  Is  Illustrated  In  Figure  1. 

*JWOun,J5roProc?ss°rs»  memory  (both  PROM  and  RAM),  DMA  1/0 
".‘SS'S?,*.*0.  *5°  '“J10  and  Interface.,  a  hexadecimal  at iplly  .ml 
hi  I’  h  f  er  Jc-eh  ‘’x!  console.  All  devices  are  connected  to  a  common 
bus  consisting  of  ^0  address  lines,  16  data  lines,  and  appropriate 
control  signals. 


hnc  JKrKLC0U?Ier.,,na¥  be  1mP1e'nented  t0  expand  the  system  to  a  dual 
bus  structure.  The  device  connected  to  the  bus  coupler  may  contain 

additional  CPUs,  memory,  and  peripheral  devices. 

2.1  Microprocessor 


Each  of  the  CPUs  In  the  IPR  Is  a  Texas  Instruments  SBP  9900 
microprocessor  using  I«L  technology.  The  9900  Is  a  16-bit  CPU  that 
Implements  69  different  Instructions  (Including  fixed  point  multiply  and 
divide)  using  seven  addressing  modes.  When  the  9900  Is  operated  with  a 
3  MHz  clock,  Instruction  execution  times  (excluding  multiply  and  divide) 
vary  from  2.7  us  to  2U.U  us  with  an  average  of  about  7  us.  Instructions 
are  one,  two,  or  three  lb  bit  words  In  length. 

The  9900  provides  16  vectored  prioritized  hardware  Interrupts. 
Instead  of  a  stack  architecture,  the  CPU  performs  "context  switching"  of 
the  processor  work  space,  program  counter,  and  status  registers.  A 
work  space"  Is  the  CPU's  16  general  purpose  registers  which  are 
resident  In  the  system's  main  memory  (rather  than  on  the  CPU  chip 
Itself),  When  a  system  call,  subroutine  call,  or  Interrupt  occurs,  a 
context  switch  Is  executed  by  saving  a  pointer  to  the  old  work  space, 
program  counter,  and  status  In  a  new  work  space  used  by  the  called 
process. 


The  9900  contains  a  special  serial  I/O  Interface  called  the  CRU 
(Communications  Register  Unit)  that  Is  utilized  In  the  IPR  to  Interface 
with  the  limit  and  bias  registers. 
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I  DISPLAY  |  |  CONSOLE  I 

I  PANEL  |  . 


.  I  CONSOLE  | 

I  CONFIG/  |  |  1/F  | 

I  DISPLAY  |  |  INTERVAL | 

I  1/F  |  |  TMR/CLK  | 


I  MASTER  |  |  MASTER  I  |  SLAVE  I  |  SLAVE  |  |  SLAVE  | 


BUS 


I  MASTER  | 


I  1622  |  |  1622  |  |  RADIO  I  |  RADIO  I  I  RADIO  I 

I  XX  |  |  TX  I  I  RX1  |  |  RX2  |  |  TX  | 

I  DMA  |  |  DMA  |  |  DMA  |  |  DMA  |  |  DMA  I 

I  1/F  I  I  1/F  I  I  1/F  |  |  1/F  |  |  1/F  | 


I  STATION  |  |  RADIO 


FIGURE  1  FUNCTIONAL  BLOCK  DIAGRAM  OF  THE  1PR  HARDWARE 
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2.2  Address  Mapping 

The  IPR's  digital  unit  Implements  a  20  bit  address  bus  to  provide 

or  1024K,  unique  word  addresses.  The  9900  CPU  Is  able  to  address 

2  unique  bytes  of  memory  or  peripherals.  However,  the  CPU  only 
outputs  a  15  bit  address  bus  and  all  memory /peripheral  operations  are 
performed  on  words.  (The  least  significant  address  bit  Is  used 
Internally  by  the  CPU  for  byte  addressing.)  All  15-bit  addresses  output 
by  the  CPU  are  modified  by  the  1PR  mapping  hardware  to  provide  a  20-b  1 1 
bus  address.  This  Is  accomplished  by  summing  the  CPU  address  with  one 
of  several  bias  registers  as  shown  In  Figure  2.  The  particular  bias 
register  used  In  the  summing  process  Is  determined  by  the  contents  of 
the  1  Imlt  registers. 

Associated  with  each  CPU  In  the  1PR  are  three  software  variable 
bias  registers,  one  fixed  bias  (hardware  strapped)  register  and  three 
software  variable  limit  registers.  These  registers  are  set  and  read 
under  software  control  via  the  CPU's  CKU  Interface.  The  three  limit 
registers,  each  7  bits  In  length,  may  be  used  to  partition  the  32K 
address  space  of  the  CPU  Into  four  zones.  The  7-blt  limit  registers  are 
compared  with  the  most  significant  7  bits  of  address  output  by  the  CPU. 
If  the  CPU  address  Is  equal  to,  or  greater  than,  limit  register  3,  then 
zone  4  Is  defined  and  the  CPU  address  is  summed  with  fixed  bias  4.  If 
the  CPU  address  Is  not  In  zone  4  and  Is  equal  to,  or  greater  than,  limit 
register  2,  then  zone  3  Is  defined  and  the  CPU  address  Is  summed  with 
variable  bias  3.  If  the  CPU  address  Is  not  In  zone  4  or  zone  3  and  Is 
equal  to,  or  greater  than,  limit  register  1,  then  zone  2  Is  defined  and 
the  CPU  address  Is  summed  with  variable  bias  2.  If  the  CPU  address  Is 
not  In  zones  2,  3,  or  4,  then  zone  1  Is  defined  and  the  CPU  address  Is 
summed  with  variable  bias  1.  The  length  of  each  zone  Is  determined  by 
the  content  of  the  limit  registers. 

When  power  Is  first  applied  to  the  CPU,  and  before  the  CPU  has  had 
time  to  define  the  limit  and  bias  registers,  a  special  mechanism  must  be 
employed  to  enable  a  default  form  of  mapping  to  occur.  In  the  normal 
mapping  mode,  the  CPU  address  Is  simultaneously  compared  to  all  three 
limit  registers  and  the  zone  decision  (based  upon  the  rules  stated 
above)  Is  presented  to  the  bias  registers  In  the  form  of  two  signal 
lines.  The  four  possible  states  of  these  two  lines  determine  which  of 
the  four  bias  registers  will  be  added  to  the  CPU  address.  However,  when 
power  Is  first  applied  to  the  system,  a  flip-flop  Is  set  on  the  mapping 
board  which  bypasses  the  limit  registers  and  forces  the  default  mapping 
to  occur.  When  the  flip-flop  Is  set,  the  two  signal  lines  to  the  bias 
registers  are  set  high  forcing  the  zone  4  bias  register  to  be  used  for 
all  CPU  addresses.  While  the  bias  registers  for  zones  1,  2,  and  3  are 
software  controllable,  the  zone  4  bias  register  Is  strapped  In  hardware 
to  be  11111 OUOOOOOo.  In  this  way  the  default  flip-flop  and  hardware 
strapped  bias  4  allows  the  system  to  begin  executing  instructions  at  a 
known  location  In  the  1024K  system  address  space.  The  default  flip- 
flop,  and  thus  the  default  mapping,  stays  set  until  the  CPU  writes  to 
limit  register  3. 
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t  •  FIGURE  2  ADDRESS  MAPPING  WITH  CPU  BIAS  AND  LIMIT  REGISTERS 


-5- 


IPR  U.S.  Users  Guide 


June  30,  1  ybJ 

The  comparison  of  a  CPU  address  with  a  limit  value  is  effectively 
done  Dy  subtracting  the  limit  value  from  the  address  and  testing  for  a 
borrow  out  of  the  most  significant  bit.  Because  the  mapping  board  was 
designed  to  perform  additions,  rather  than  subtractions,  tne  limit 
register  must  be  loaded  with  the  two's  complement  of  the  intended  limit 
value.  The  comparison  of  the  CPU  address  with  the  limit  value  is  then 
performed  by  adding  the  CPU  address  to  the  limit  register  and  testing 
for  a  carry  out. 

2.  3  Memory 


The  IPR  utilizes  read  only  (PROM)  and  random  access  (RAM)  memory. 
Parity  is  generated  and  checked  on  each  16  bit  PROM  or  RAM  word.  Most 
of  the  IPR  operating  system  resides  in  PROM.  The  remainder  of  the 
operating  system,  and  all  of  the  user  processes,  are  resident  in  RAM. 
figure  3  lists  the  address  at  which  memory  exists  in  the  IPR. 


20  BIT 

BUS  ADDRESS 
(BASE  1 o) 

16  BIT 

CPU  ADDRESS 
(BASE  16) 
(before  biasing) 

IMPLEMENTATION 

00000  -  U2BPF 

UOOU  -  55FE 

11 K  WORDS  RAM 

04U00  -  04FFF 

6U00  -  yFFE 

4K  WORDS  RAM 

FU400  -  FUFFF 

A800  -  BFFE 

3K  WORDS  RAM 

FECOO  -  FEFFF 

0800  -  DFFE 

IK  PERIPHERAL 

FF000  -  FFFFF 

E000  -  FFFE 

4K  WORDS  PROM 

FIGURE  3 

IPR  MEMORY  ORGANIZATION 

Interrupt  Assignments 

The  9900  CPU  implements  16  interrupt  levels  with  level  0  being  tiie 
highest  and  level  15  being  the  lowest.  When  the  level  of  a  pending 
interrupt  is  less  than,  or  equal  to,  the  enabling  mask  level  (higher  or 
equal  priority  interrupt),  the  CPU  recognizes  the  interrupt  and 
initiates  a  context  switch  following  completion  of  the  currently 
executing  instruction.  The  processor  fetches  the  new  context  workspace 
pointer  ( WP)  and  program  counter  (PC)  from  the  appropriate  interrupt 
vector  in  tne  CPU's  zone  1.  Then,  the  previous  context  WP,  PC,  and 
status  are  stored  in  workspace  registers  R13,  R14,  and  RI5, 
respectively,  of  the  new  workspace.  The  CPU  then  forces  the  interrupt 
mask  co  a  value  that  is  one  less  tnan  the  level  of  tne  interrupt  being 
serviced.  (When  a  level  0  interrupt  is  being  serviced,  the  mask  is  sec 
to  U.  )  This  allows  only  interrupts  of  higher  priority  to  interrupt  a 

service  routine.  The  IPR's  interrupt  vector  assignments  are  shown  in 
Figure  4. 
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The  specific  Interrupts  are  unique  to  each  CPU.  Each  CPU  may 
Independently  be  Interrupted  by  the  specific  Interrupt  source.  Common 
Interrupts  generate  an  Interrupt  to  both  CPUs  from  a  single  Interrupt 
source.  The  operating  system  software  resolves  contention  so  that  only 
one  CPU  performs  the  Interrupt  servicing  of  the  common  Interrupts. 

A  failure  Interrupt  Is  generated  whenever  a  bus  response  timeout 
from  memory  Is  detected,  an  Invalid  Instruction  operation  Is  detected,  a 
memory  parity  error  occurs,  or  the  "watch  dog  timer"  Interval  has 
elapsed. 

A  CPU  directed  1  nterrupt  Is  generated  by  operating  system  software. 
A  CPU  can  Interrupt  Itself  or  any  other  CPU  In  the  system. 

The  Interval  timer  decrements  the  16  bit  value  loaded  by  the 
software  and  generates  an  Interrupt  when  the  value  reaches  zero.  Each 
count  of  the  Interval  timer  equals  1.667  msec. 

An  interrupt  is  generated  by  the  Radio  or  1622  transmit  or  receive 
uma's  upon  completion  of  a  DMA  data  transfer. 

2.5  Extended  operations  (XUPs) 

The  extended  operation  (XOP)  Instruction  is  used  for  interfacing 
with  the  operating  system  software.  Several  vectors,  similar  to  the 
interrupt  vectors,  are  defined  for  specific  operating  system  functions. 
The  XOP  vector  assignments  are  shown  In  Figure  5. 

2.6  Special  Purpose  Instructions 

The  CKON,  IKUF,  KSET  and  AbS  Instructions  are  utilized  by  the  IPR 
to  perform  special  system  functions.  While  the  ABS  Instruction  may  be 
used  by  any  user  job  to  resolve  contention,  the  CKON,  CKOF  and  RSET 
Instructions  are  reserved  for  use  by  the  operating  system. 

2.6.1  CK  ON/  CKOF 

The  CKON  Instruction  Is  used  to  enable  and  restart  the  CPU 
"watch  dog  timer".  The  watch  dog  timer  Interval  Is  approximately  2 
seconds.  The  CKOF  Instruction  disables  the  watch  dog  timer.  Each  IPR 
CPU  Implements  a  watch  oog  timer. 
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Speci fic 
Speci fic 


Speci fic 
Common 

Common 

Common 

Common 

Common 

Common 

Common 


Reset  (Unused) 

Failure;  Bus  Response  Timeout, 
Invalid  Op-Code,  Memory  Parity 
Error,  Watch  Uog  Timer 

Unused 

CPU  Directed 
Interval  Timer 
Unused 
Console  I/O 

Radio  Receive  Channel  1 
Radio  Receive  Channel  2 
Radio  Transmit 
Unused 

1822  Receive 
1822  Transmit 
Unused 
Unused 
Unused 


€ 

FIGURE  4  IPR  INTERRUPT  VECTOR  ASSIGNMENTS 
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Job  Control  (Scheduler) 
Job  Call 

Trace  Breakpoint 

Buffer  Management 

Console  I/O 

Radio/1822  DMA  1/0 
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Utility 

1 822  Ready 

Down  Load 

I/O  Tags 
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FIGURE  5  XOP  VECTOR  ASSIGNMENTS 

2.6.2  RSET 


The  RSET  instruction  invokes  restart  initialization  of  all 
CPUs  in  the  1PR. 

2.6.3  ABS 

The  ABS  instruction  is  used  to  resolve  contention  for  commonly 
used  processes  or  data  structures.  The  ABS  instruction  generates  the 
absolute  value  of  a  specified  signed  two's  complement  operand.  The 
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CPU  s  status  word  is  modified  based  on  the  value  of  the  operand  before 
the  absolute  value  is  calculated  and  stored.  Also,  special  hardware  in 
the  1PR  recognizes  when  the  ABS  instruction  is  being  executed  and  makes 
the  operand  fetch/modi fy/store  operations  indivisible.  That  is,  once 
access  to  the  bus  has  been  granted  to  fetch  the  operand,  the  bus  is  not 
released  until  the  absolute  value  of  the  operand  has  been  stored.  Thus, 
all  other  CPUs  are  inhibited  from  gaining  access  to  the  operand  during 
the  execution  of  the  AbS  instruction.  These  features  of  the  ABS 
instruction  allow  the  creation  of  flags  to  resolve  contention  between 
jobs  for  a  common  data  structure.  Such  a  contention  flag  is  nothing 
more  than  a  location  in  memory  that  contains  alternately  positive  and 
negative  numbers.  (In  the  IPR,  plus  and  minus  one  are  typically  used.) 

A  negative  value  in  a  contention  flag  indicates  the  associated  data 

structure  is  not  being  used  by  another  job.  To  gain  access  to  the  data, 

a  job  performs  an  ABS  instruction  on  the  contention  flag  and  the  flag  is 
left  with  a  positive  value.  If  the  status  word  indicates  the  flag  was 
negative,  then  the  job  knows  the  data  was  not  being  used  and  is  now  free 
to  access  the  data.  If,  after  performing  the  ABS  instruction  on  the 
flag,  the  status  word  indicates  the  flag  was  al  ready  positive,  then  the 

job  knows  the  data  is  already  being  accessed  by  another  job. 

2.7  Direct  Memory  Access  (DMA)  Interfaces 

2.7.1  Radio  DMA  I/O 

The  radio  transmit/receive  channels  implement  the  IPR  digital 
unit  interface  with  the  IPR  radio.  The  operating  system  software 
enables  the  radio  reception  of  a  packet  by  enabling  one  or  both  of  the 
radio  receive  DMA  channels.  Either  radio  receive  DMA  channel  (if 
enabled)  may  receive  a  100  or  400  Kbit  data  packet.  Thus,  receiver 
blocking,  the  situation  where  a  packet  cannot  be  received  for  want  of  an 
enabled  receive  channel,  is  minimized  in  the  IPR. 

A  radio  packet  transmit  is  initiated  by  the  enabling  of  the 
radio  transmit  DMA  channel.  The  transmit  may  occur  immediately,  in 
which  case  a  packet  currently  being  received  will  be  lost,  or  the 
transmit  may  be  delayed  until  the  RF  channel  is  sensed  to  be  unused. 

A  CPU  interrupt  is  generated  upon  completion  of  a  radio  packet 
transmission  or  reception. 

2.7.2  1822  DMA  I/O 

The  1822  transmit/receive  channels  provide  for  full  duplex 
transfer  of  packets  to  an  attached  host  computer.  The  1822  DMA  channels 
are  normally  used  to  interconnect  network  terminals  and  stations  to  the 
IPR.  A  CPU  interrupt  is  generated  upon  completion  of  an  1822  DMA  packet 
transmission  or  reception. 


2.8  Operator  Consol  e 


The  IPR  will  support  an  operator  console  connected  to  the  1/0 
channel  (RS-232)  interface.  Asing’e  console  is  time  shared  for 
communication  with  all  software  processes  resident  in  the  IPR. 

2.9  Elapsed  Time  Clock  and  Interval  Timer 

The  IPR  implements  a  single  32  bit  elapsed  time  clock.  The  least 
and  most  significant  words  of  the  clock  may  be  read  by  IPR  software 
processes  for  the  determination  of  elapsed  time.  The  least  significant 
clock  word  has  a  tick  rate  of  6.51  usee,  and  the  most  significant  clock 
word  has  a  tick  rate  of  427  msec. 

The  IPR  also  implements  a  16  bit  interval  timer.  The  timer  may  be 
loaded  with  any  16  bit  binary  count.  The  count  is  decremented  at  a  rate 
of  1.667  msec  and  a  CPU  interrupt  is  generated  when  the  count  reaches 
zero.  The  interval  timer  is  reserved  for  use  by  the  operating  system 
software. 

2. 1 U  Manual  Control  and  Display 

The  control/displ  ay  panel  is  illustrated  in  Figure  6.  This  panel 
is  located  on  the  front  of  the  IPR  digital  unit  under  a  hinged  door. 

The  code  and  data  hexadecimal  (0-9,  A-F)  display  may  be  set, 
blanked  (turned  off),  or  blinked  by  the  PR  software.  It  is  utilized  to 
display  status  and  define  failure  during  initialization  and  normal 
operation  of  the  IPR. 


The  initialization  (INIT)  pushbutton  switch  is  depressed  to  invoke 
power-up  initialization  of  the  PR.  The  restart  ( RSET)  pushbutton  switch 
is  used  to  invoke  restart  initialization  of  the  PR.  The  RSET  pushbutton 
operation  is  functionally  identical  to  the  RSET  instruction. 

The  remaining  LED  displays  are  directly  driven  by  the  hardware  and 
are  not  under  direct  control  of  the  PR  software.  The  run  indicators, 
when  illuminated,  indicate  that  the  defined  CPU  is  fetching 
instructions,  and  that  it  is  not  idled  (IDLE  instruction)  or  failed. 

The  fault  indicator  (FLT)  is  illuminated  for  approximately  2 
seconds  whenever  a  bus  response  timeout,  invalid  op-code,  memory  parity 
error,  or  elapsed  watch  dog  timer  error  occurs. 
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COUE  DATA 


•  •  •  • 

•  •  •  • 


IN1T  RN1  RN2  FlT  TX  RX1  RX4  RSET 
0  0  0  0  0  0  0  (  ) 


LEGEND 

CODE  Two-digit  Hexadecimal  Display 

DATA  Four-digit  Hexadecimal  Display 

1N1T  Power-up  Initialization  Switch 

RSET  Restart  Initialization  Switch 

RN1  CPU  1  Run  Indicator  LED 

RNL  CPU  2  Run  Indicator  LED 

FLT  IPR  Fault  Indicator  LED 

TX  Radio  Transmit  Indicator  LED 

RX1  Radio  100kbps  Receive  Indicator  LED 

RX4  Radio  400kbps  Receive  Indicator  LED 


FIGURE  b  IPR  MANUAL  CONTROL/DISPLAY  PANEL 
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The  radio  transmit  indicator  (TX)  is  lit  for  the  duration  of  a 
packet  transmission.  The  radio  receive  100  Kbit  (RX1),  or  400  Kbit 
(RX4)  receive  indicators  are  lit  for  the  duration  of  the  packet 
reception. 

2.11  Hardware  Strapping  Options 

^hardware  straps  utilized  by  the  I  PR  system  software  are  located  on 
the  Configuration/Display  interface"  and  "1/0  Channel  and  Interval 
Timer  pri nted  circuit  boards. 

2.11.1  Con?iguration/Uispl  av  Interface 

Four  DIP  socket  packages  are  located  on  the  top  left  corner  of 
this  board  when  viewed  with  the  backplane  connector  facing  to  the  riqht. 
tach  package  contains  eight  straps.  When  a  strap  is  inserted  in  the  socket, 
the  system  software  reads  a  binary  zero. 

2.11.1.1  PR  JJD 

The  two  left-most  strap  packages  define  the  PR's  ID. 

The  most  significant  bit  of  the  16-bit  PR  ID  is  the  leftmost  strap  of 
the  two  ID  packages. 

2.11.1.2  Auto-restart  Enable 

The  left-most  strap  of  the  third  strap  package  enables 
(1)  or  disables  (U)  auto-restart  in  the  event  of  failure  of  the  1PR. 

2.11.1.3  Down- Li ne  Load  Enable 


The  second  strap  of  the  third  strap  packaga  enables  (1) 
or  inhibits  (0)  tha  request  for  a  down-line  load  by  the  1PR  software 
during  the  I  PR  initialization. 

2.11.1.4  Default  RF  Frequency 

The  right-most  six  straps  of  the  third  strap  package 
define  the  de.ault  radio  RF  frequency  utilized  for  down-line  loading  of 

the  IPR.  The  binary  value  in  the  straps  and  the  corresponding  RF 
frequency  are  shown  below.  3 
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STRAPS 


1 1 1001 
111000 
1101 11 
1 1 01 1 0 
1101  01 
110100 
11001  1 
110010 
110001 
110000 
101001 
101000 
loom 
100110 
100101 
100100 
10001  1 
100010 
1 00001 
100000 
01  1001 


RF  FREQ  (MHZ) 


1712.3 

1718.7 

1  725.1 

1731.5 
1  737.9 

1744.3 
1  750.7 

1757.1 
1  763.5 

1769.9 
1  776.3 

1782.7 

1789.1 

1795.5 

1 801 . 9 

1808.3 

1814.7 

1821.1 

1827.5 

1833.9 

1840.3 
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,The  six  frequency  straps  are  used  to  control  a  6-bit 
BCD  divide  chain.  The  allowable  strap  values  shown  above  represent  BCD 
numbers  ranging  from  1910  to  39 in.  If  a  BCD  number  less  than  19  is 
used,  the  frequency  generated  will  be  too  high  and  will  be  Altered  out 
in  the  RF  head.  There  are  no  BCD  numbers  higher  than  the  legal  39.  If 
the  straps  are  set  to  a  value  that  is  not  a  valid  BCD  number,  the 
frequency  generated  is  indeterminate. 

2.11.1.5  Initialization  Control 

The  left-most  five  straps  of  the  right-most  strap 
package  are  available  for  applications  software  use.  The  remaining  three 
straps  are  used  for  special  maintenance  and  test  options  during 
initialization.  All  straps  in  this  package  are  normally  set  to  binary  zero. 

Strap  6  Loop  on  Error 

Strap  7  Write  Memory  in  Loop  on  Error 

Strap  8  Do  mini  -initial  ization 

2.11.2  I/O  Channel  and  Interval  Tinier 

Hardware  strapping  options  are  implemented  on  the  I/O  channel 
and  Interval  Timer  PC  board  to  define  the  type  and  BAUD  rate  of  the 
terminal  device  connected  to  the  RS-232  I/O  channel  port. 
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2.11.2.1  Terminal  Type 

One  type  of  terminal  that  is  commonly  used  with  the  IPR 
is  the  T I  i lent  700  terminal.  The  Silent  700  is  a  hard-copy  terminal 
that  will  transmit  and  receive  characters  at  baud  rates  up  to  1200,  but 
mechanical  reasons  prevent  the  terminal  from  printing  more  than  30 
characters  per  second.  In  order  to  accommodate  use  of  the  Silent  700 
with  the  IPR,  a  slide  switch  is  provided  on  the  front  edge  of  the  I/O 
channel  board.  When  this  switch  is  in  the  down  position,  the  hardware 
inserts  a  25  msec  delay  between  the  Uart's  "TX  Ready"  signal  and  the 
generation  of  an  interrupt.  This  delay  is  sufficient  to  limit  the 
effective  character  rate  to  30  characters  per  second.  When  the  slide 

switch  is  in  the  up  position,  no  artificial  delays  are  inserted  by  the 
n  3  rawa  re  • 


2.11.2.2  Terminal  Baud  Rate 

The  baud  rate  is  specified  in  a  rotary  switch  facing  the 
front  of  the  PC  board.  The  switch  positions  and  their  corresponding 
baud  rates  are  shown  below.  a 

SWITCH  POSITION  BAUD  RATE 


0 

1 

2 

3 

4 

5 

6 

7 

8 
9 


no 

150 

300 

2400 

1200 

1800 

4800 

9600 

2400 

600 


W  h i 1 e  the  I  PR's  UART  is  able  to  transmit  and  receive 

individual  characters  at  all  of  these  baud  rates,  the  CPU  is  not  fast 

enough  to  input  a  continuous  stream  of  characters  above  4800  baud.  In 

other  words,  a  user  can  communicate  with  the  IPR  at  9600  baud  if  the 

Jo,mVs,ifrom  a  Aboard,  but  software  can  not  De  loaded  at  rates  above 
*touu  oaua. 
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3  OPERATING  .SYSTEM  S0F1WARE  DESCRIPTION 


3.1  Uvervlew 


The  two  major  goals  of  the  operating  system  design  were  to  optimize 
processing  speed  In  the  multiprocessor  PR  and  provide  a  structure  which 
permitted  modular  expansion  of  the  IPR  hardware  and  software.  Maximum 
processing  speed  Is  obtained  by  maximizing  the  concurrent  parallel 
execution  of  the  PR  processing  tasks.  The  operating  system's  design 
provides  for  expansion  to  a  multibus  (multicluster)  architecture  with 
additional  CPUs,  memory,  and  peripheral  devices. 

The  operating  system  Implements  a  multi  programmed  event-driven 
processing  environment  for  the  PR  processing  tasks.  Multiple 
Independent  user  processes,  hereafter  called  jobs,  may  be  executed 
concurrently  In  the  Pk.  Each  CPU  Independently  executes  the  operating 
system  processes  and  system  Jobs.  Each  CPU  contends  with  the  other  CPUs 
to  process  the  system  tasks.  Processing  tasks  are  not  dedicated  to  CPUs 
and  all  CPUs  have  equal  access  to  the  PR  system  memory.  Each  CPU  may 
periodically  execute  a  system  Job  and  perform  Interrupt  processing  of 
the  common  Interrupts.  Separate  common  Interrupts  are  processed 
simultaneously  by  the  two  CPUs. 

Processing  Is  scheduled  In  the  PR  based  upon  the  first  In/first  out 
occurrence  of  an  event  and  the  relative  execution  priorities  of  these 
events.  Four  execution  priorities  are  currently  defined  by  the 
operating  system.  These  are  listed  below  In  the  order  of  highest  to 
lowest  prl orlty; 

Executl ve 

Job  Prl  orlty  1 

Job  Priority  2 

Job  Priority  3  (Debug  only) 

Idle 

Each  CPU's  execution  priority  varies  with  time  and  equals  the 
priority  of  the  task  It  Is  currently  executing.  If  a  CPU  finds  no 
processing  tasks  scheduled,  It  will  go  Idle  (cease  executing)  until  the 
occurrence  of  an  Interrupt.  Idling  the  CPU  Is  done  to  reduce  system  bus 
contention.  When  a  processing  task  Is  scheduled,  all  CPUs  are  alerted 
via  generation  of  an  Interrupt. 

Jobs  are  scheduled  for  execution  based  upon  the  occurrence  of  an 
event.  An  event  may  be  the  completion  of  an  1/0  operation,  passage  of  a 
time  Interval  specified  by  a  Job,  an  Inter-Job  call  or  an  operator 
console  command.  An  event  Is  processed  by  executing  a  job.  When  the 
processing  has  completed,  the  Job  suspends  execution  until  occurrence  of 
another  event.  The  operating  system  passes  the  Job  call  event 
parameters  between  Independent  processes  and  saves/ re  stores  the  machlno 
tfL,  state  for  each  system  Job. 


1PK  0.8.  Users  Guide 


June  30,  1983 


Jobs  are  created  In  the  Pk  by  loading  of  Job  object  code  remotely 
via  the  radio  or  1822  Interfaces  or  via  the  local  console  Interface, 
t-ach  Job  Is  preassigned  a  unique  name  and  Identification  number.  This 
Is  done  to  facilitate  operator  monitoring  and  control  and  Interjob 
communications. 

Operation  of  the  PR  may  be  unattended  or  totally  under  operator 
control  via  local  console  commands.  These  local  console  commands  enable 
an  operator  to  control  and  monitor  PR  operation  plus  provide 
capabilities  for  software  debugging. 

The  operating  system  Implements  built  in  test  (BIT)  diagnostics 
executed  when  the  PR  Is  Initialized  or  has  failed.  Auto-restart  in  the 
event  of  failure  is  provided. 

The  major  processes  of  the  PH  operating  system  are  Illustrated  In 
Figure  7  and  briefly  described  below.  They  are  defined  In  greater 
detail  In  the  following  paragraphs  of  Section  3. 

POWLR-UP  INITIALIZATION/BIT  DIAGNOSTICS  -  Initializes  the  PR 
from  a  never  executed  state.  BIT  diagnostics  verify  PkOM 
contents,  test  mapping  registers,  and  RAM  memory.  The 
remaining  portion  of  the  operating  system  Is  loaded  and 
the  operating  system  RAM  Is  Initialized. 

RESTART  INITIAL 1ZAT ION/b I T  DIAGNOSTICS  -  Reinitializes  a  PR 
which  has  failed  or  Is  restarting.  All  Jobs  are 
checksummed  and  reinitialized  equivalent  to  the  Initial 
load  of  the  Jobs.  Down-line  loading  Is  requested  If 
auto-restart  and  down-line  load  hardware  straps  are 
enabled  and  no  Jobs  are  resident  or  a  Job  code  space 
checksum  error  Is  detected. 

JOB  CONTROL  (MONITOR/SCHEDULE)  -  Includes  all  processes 
utilized  to  monitor  and  control  job  execution.  These 
Include  the:  scheduler,  Interjob  call,  Interval  timer, 
clock  queue  service,  CPU  directed  Interrupt,  PR  failure 
Interrupt  (bus  timeout,  memory  parity  error,  Invalid 
Instruction  code,  watch  dog  timer). 

CONTROL/MONITOR  (DEBUG)  JOB  -  Operating  system  process 

executed  as  a  system  Job.  It  Implements  operator  console 
commands  utilized  to  monitor  and  control  Job  execution 
and  provide  software  debug  aids. 
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PROCESSES 

.  Power-Up  Initial Izatlon/BIT  Diagnostics 
.  Restart  Inltlallzatlon/BIT  Diagnostics 
.  Job  Control  (Scheduler/Monitor/Fault  Intercept) 
.  Radio/1822  DMA  1/0 
.  Console  (I/O  Channel)  1/0 
.  Buffer  Management 
.  Kemote/Local  Software  Loaders 
.  Utilities 

.  operator  Control /Monitor  (Debug)  Job 
DATA  STRUCTURES 

.  PK  Configuration  Table 
.  CPU  Configuration  Table 
.  CPU  State  Table 
.  System  Job  Index 
.  System  Job  LI  st 
.  Job  Dispatch  Queues 
.  Job  Clock  Queues 
.  Packet  Buffers 


FIGURE  7  MAJOR  ELEMENTS  OF  THE  IPR  OPERATING  SYSTEM  SOFTWARE 
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CONSOLE.  1/0  AND  INTERRUPT  SERVICE  -  Provides  local  1/0  channel 
console  input/output  services  for  the  operating  system 
and  system  jobs.  Capabilities  are  provided  for  time 
sharing  the  single  console  between  the  several 
independent  user  processes. 

RAOIO/1822  DMA  I/O  INTERRUPT  SERVICE  -  Queues  and  executes 
Radio  and  1822  DMA  I/O  events  as  requested  by  the 
operating  system  and  system  jobs. 

LOCAL  CONSOLE/OOWN-LINE  LOADERS  -  Implements  the  loading  of 
the  operating  system  and  system  jobs  via  the  local 
console  (RS-232)  interface  or  remotely  via  the  radio  or 
1822  DMA  I/O  interfaces. 

BUFFER  MANAGEMENT  -  Allocates  the  eleven  packet  buffers  upon 
request  from  the  operating  system  and  system  jobs. 

PR/CPU  CONFIGURATION  TABLES  -  Contain  data  to  define  PR  and 
CPU  initialization. 

CPU  STATE  TABLES  -  One  for  each  CPU  which  contain  dynamic  data 
to  define  the  execution  priority  of  the  CPU  and  define 
the  CPU  machine  state  in  the  event  of  failure. 

JOB  CLOCK  QUEUE  -  Queue  of  jobs  and  time  interval  to 
reschedule  job  execution. 

SYSTEM  JOB  LIST/ JOB  INDEX  -  Defines  resident  jobs  and  current 
execution  status  and  machine  state  of  resident  system 
jobs.  A  system  job  may  be:  idle  (never  executed  when 
called),  halted  (due  to  failure  or  operator  command), 
checkpointed  (execution  stopped  due  to  other  system 
halt),  suspended  (waiting  for  next  job  call),  or  busy 
(executi ng) . 

JOB  DISPATCH  QUEUES  -  Defines  call  to  execute  system  job  plus 
call  parameters  to  define  reason  for  call.  Three  queues 
are  implemented,  one  each  for  priority  1,  priority 
2,  and  priori ty  3  jobs. 

3.2  Structure  and  Organization 

ihe  32K  word  address  space  of  each  CPU  is  divided  into  4  mutually 
exclusive  zones.  Each  CPU  implements  one  additional  address  bit  for  a 
total  of  65K  addresses  which  is  used  internally  for  byte  addressing. 
Each  zone  is  dedicated  to  specific  functional  elements  of  the  system 
software  as  illustrated  in  Figure  8. 

Each  CPU  implements  a  separate  zone  1  which  contains  the  CPU's 
interrupt  and  XUP  vectors  and  workspaces  used  by  the  CPU  for  execution 
of  the  operating  system. 
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CPU  ADDRESS  SPACE  ZONE  BUS  ADDRESS  SPACE 


0000  |  256  WORDS  RAM: 


-OPERATING  SYSTEM 
WORKSPACES 
-INTERRUPT/XOP 
VECTORS 


0200 


55FE 


8000 


9FFE 


A8U0 


BFFF 


D8U0 


EOOO 


FFFF 


10. 5K  WORDS  RAM: 
-JOBS 
*CODE 

*WORKSPACE 
*LOCAL  BUFFERS 


4K  WORDS  RAM: 

-GLOBAL  DATA  BASE 
-PACKET  BUFFERS 


3K  WORDS  RAM: 

-OPERATING  SYSTEM 
*CODE 

*LOCAL  BUFFERS 


IK  WORDS  ADDRS: 
-I/O  TAGS 


4K  WORDS  PROM: 

-OPERATING  SYSTEM 
CODE 


ZONE  1 


ZONE  2 


ZONE  3 


ZONE  4 


ZONE  1  -  CPU  1 
RAM 


ZONE  1  -  CPU  2 
RAM 


ZONE  2 
BOTH  CPUs 
RAM 


ZONE  3 
BOTH  CPUs 
RAM 


ZONE  4 
BOTH  CPUs 
RAM 


ZONE  4 
BOTH  CPUs 
I/O  TAGS 


ZONE  4 
BOTH  CPUs 
PROM 


00000 

00100 

00200 

02BFF 

04000 

04FFF 

FD400 

FDFFF 

FECOO 

FFOOO 

FFFFF 


FIGURE  8  CPU  ADDRESS  MAPPING  INTO  IPR  SYSTEM  ADDRESS  SPACE 
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Zone  2  1s  utilized  for  the  system  jobs'  code  space,  workspaces,  and 
local  buffer  with  exception  of  the  Debug  job  which  resides  In  zone  4. 

Each  job  Is  relocatably  loaded  Into  zone  2  address  space.  The  system 
loader  assigns  a  bias  register  2  value  for  each  Job  equal  to  the 
beginning  of  each  job.  Jobs  are  packed'ln  contiguous  memory  locations 
to  optimize  memory  utilization. 

Zone  3  Is  utilized  for  the  system's  global  data  base.  It  contains 
all  buffer  space  which  must  be  accessible  by  more  than  one  job,  such  as 
the  packet  buffers. 

Zone  4  contains  the  operating  system  code,  tables,  and  time-varying 
buffer  space.  Additionally,  zone  4  contains  the  peripheral  device 
addresses. 

All  address  mapping  registers  are  defined  by  the  operating  system. 

System  jobs  perform  no  address  mapping  modifications.  Address  mapping 
Is  transparent  to  the  system  jobs. 

3.3  Data  Structures 


Several  tables  and  queues  are  defined  by  the  operating  system  which 
are  utilized  to  Initialize,  describe,  control,  and  monitor  job  execution 
in  the  1PR.  These  are  described  below. 

3.3.1  PR  Configuration  Table 

The  PR  Configuration  Table  contains  non-volatile  Information 
utilized  to  initialize  the  PR  and  define  pertinent  PR  configuration 
data.  This  table  contains  table  and  queue  addresses,  Initialization 
routine  vectors,  and  Images  of  the  zone  1  CPU  addresses,  and  other 
similar  data.  The  PR  Configuration  Table  Is  Implemented  In  zone  4. 

3.3.2  CPU  Configuration  Table 

Each  CPU  Is  provided  with  a  Configuration  Table.  This  table 
contains  non-volatile  Information  utilized  to  Initialize  the  CPU  and  to 
define  pertinent  configuration  data  unique  to  each  CPU.  The  table 
Includes:  CPU  Identity  data,  CPU  mapping  register  values,  peripheral 
addresses  (Interval  timer,  Interrupt  register),  table  and  queue 
addresses,  and  other  similar  data.  The  CPU  Configuration  Tables  are 
Implemented  In  zone  4. 

3.3.3  CPU  State  Table 

Each  CPU  Is  provided  with  a  State  Table.  It  contains  volatile 
Information  to  define  the  current  execution  state  of  the  CPU.  Each  CPU 
State  Table  Includes:  a  contention  flag,  the  CPU  name,  current  CPU 
w  execution  priority,  and  the  machine  state  of  the  CPU  In  the  event  of 
|jp  failure  or  termination  of  execution.  The  CPU  execution  priorities 
|!  -  defined  In  order  of  highest  to  lowest  priority  are: 
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Executive 

Job  Priority  1 

Job  Priority  2 

Job^  Priority  3  (Debug  only) 

Each  CPU  compares  its  current  execution  priority  with  the 
current  execution  priority  of  other  CPUs  to  determine  which  CPU  should 
process  a  common  interrupt. 

The  CPU  machine  state  is  captured  in  the  CPU  State  Table  in 
the  event  of  a  CPU  detected  failure,  if  execution  is  terminated  by 
operator  command,  if  a  software  trace  breakpoint  is  encountered,  or  if  a 
job  halts.  The  machine  state  is  represented  by  the  current  value  of  the 
CPU  registers  (SI,  PC,  WP),  and  the  contents  of  the  workspace  beinq 
used.  3 

3.3.4  System  Job/CPU  Index 

Each  system  job  and  CPU  are  uniquely  defined  by  a  name  (ASCII 
character  string)  and  an  eight  bit  ID.  The  System  Job  Index  is  utilized 
by  the  operating  system  to  define  the  existence  of  a  CPU  or  to  define  a 
resident  job.  The  table  contains  a  one  word  entry  for  each  system  CPU 
or  job.  The  CPU  or  job  ID  is  utilized  to  index  the  table.  A  zero  value 
entry  defines  a  non-implemented  CPU  or  a  non-resident  job.  A  non-zero 
entry  defines  the  CPU  State  Table  address  of  the  CPU,  or  the  address  of 
the  System  Job  List  entry  assigned  to  a  resident  job.  A  CPU's  System  Job 
Index  entry  is  defined  during  PR  initialization.  A  job's  System  Job  Index 
entry  is  defined  by  the  system  loader  when  a  job  is  loaded  into  the  PR, 
except  for  the  operating  system  Operator  Control/Monitor  (Debug)  job  and 
Station  Ready  Control  (Flap)  job  which  are  defined  during  PR  initialization. 

3.3.5  System  Job  Li  st 

The  System  Job  List  consists  of  several  variable  length 
entries,  each  of  which  defines  the  current  execution  state  of  a  resident 
system  job.  A  System  Job  List  entry  is  assigned  to  a  job  by  the  system 
loader  when  a  job  is  loaded,  except  for  the  operating  system  Operator 
Control /Monitor  (Debug)  job  and  Station  Ready  Control  (Flap)  job  which  are 

assigned  during  PR  initialization.  A  System  Job  List  entry  contains  the 
following: 

Contention  FI  ag 
Job  Name 
Job  ID 

Job  Execution  Priority 

Job  Initialization/Restart  PC 

Job  Status  (ST)  Register 

Job  Workspace  Pointer  (WP)  Register 

Job  Execution  State 

Executing/Last  Executed  CPU  ID 

CPU  Execution  Vector 
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Checksum  Start  Address 
Checksum  End  Address 
Checksum  Datum 
Job  Dispatch  Queue  Address 
Job  Bias  Register  2  Va'iue 
Job  Relocation  Displacement 
Job  Call  Counter 


The  two  byte  contention  flag  equals  0  if  the  entry  is  empty, 
+1  if  the  entry  is  in  use,  or  -1  if  not  in  use. 


The  six  byte  job  name  contains  the  unique  preassigned  job  name 
consisting  of  six  ASCII  characters  terminated  with  ETX. 

The  one  byte  binary  encoded  job  ID  uniquely  defines  the  system 
job.  Job  IDs  are  preassigned  to  all  system  jobs. 

The  one  byte  job  execution  priority  equals  binary  1,  2,  or  3.  Une 
is  the  highest  execution  priority.  Priority  3  applies  only  to  the  Debug  job. 

The  two  byte  job  initial  ization/restart  PC  defines  the  initial 
entry  address  of  the  job  for  power-up  or  restart  initialization. 

The  job  ST,  PC,  and  WP  entries,  each  two  bytes  in  length, 
contain  the  current  value  of  the  job's  CPU  registers. 

The  two  byte  job  execution  state  defines  the  current  run 
status  of  the  job.  The  most  significant  byte  contains  several  one  bit 
fields  which  describe  the  job  halt  status.  Each  bit,  if  equal  to  1, 
defines  the  following: 


bi t  0  -  Watch  Dog  Timer  Elapsed  Fault 

Bit  1  -  Bus  Response  Timeout  Fault 

Bit  2  -  Invalid  Instruction  Operation  Code  Fault 

Bit  3  -  Memory  Parity  Error  Fault 

Bit  4  -  Software  Trace  Breakpoint  Halt 

Bit  5  -  Unused  Hardware  Interrupt  Fault 

Bit  6  -  Job  Fault  (XOP  HALT,  JBCTRL  Call) 


The  least  significant  byte  is  binary  encoded  to  describe  the 
job  s  current  run  status,  as  follows: 


VALUF.  (BASE  16) 


00 

01  -  03 
04 
05 
07 

08  -  FF 


RUN  STATUS 


Idle 

Suspended 

halted 

Checkpointed 

Busy 

Invalid  (Halted) 
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A  job  Is  Idle  If  It  has  never  executed  or  Is  being 
reinitialized.  A  job  suspends  (ceases  executing)  via  appropriate 
operating  system  call  when  It  has  no  further  processing  to  perform.  It 
Is  re-executed  when  called  by  the  operator,  by  another  job,  or  when  an 
event  previously  requested  by  the  job  completes,  or  a  job  specified  time 
has  elapsed.  A  job  Is  checkpointed  (execution  ceases  with  the  machine 
state  captured)  If  the  PR  Is  halted  due  to  failure  or  trace  breakpoint. 
Job  execution  Is  halted  due  to  failure  or  software  trace  as  described 
above  In  bits  0-5.  A  job  Is  busy  when  executing  by  one  of  the  PK  CPUs. 


The  one  byte  CPU  execution  vector  defines  the  system  CPUs 
which  may  execute  the  job.  Each  bit.  If  one,  enables  execution. 


BIT 

CPU 

bit  7 

CPU 

bit  6 

CPU 

bit  5 

CPU 

bit  4 

CPU 

bit  3 

CPU 

bit  2 

CPU 

bit  1 

CPU 

bit  0 

CPU 

The  two  byte  checksum  start  address  Is  the  address  of  the 
first  word  accumulated  Into  the  checksum  calculation.  The  two  byte 
checksum  stop  address  Is  the  address  after  the  last  word  accumulated 
into  the  checksum  calculation.  The  two  byte  checksum  datum  Is  the  value 
of  the  final  accumulation.  The  datum  is  generated  by  the  system  loader, 
and  then  used  by  the  job's  checksum  test  during  Restart  Initialization. 
If  the  checksum  start  address  Is  zero,  checksum  generation/testing  Is 
not  done. 


The  two  byte  job  dispatch  queue  address  inserted  by  the  system 
loader  defines  the  absolute  job  dispatch  queue  address  used  for  the  job 
calls. 


The  two  byte  job  bias  2  register  value  defines  the  256-byte 
zone  2  memory  page  where  the  job  resides.  This  value  is  selected  by  the 
system  1  oader. 

The  two  byte  relocation  displacement,  determined  by  the  system 
loader,  defines  the  job's  displacement  (in  bytes)  from  the  beginning  of 
the  zone  2  memory  page. 

The  two  byte  job  call  counter  contains  the  binary  count  of  the 
number  of  calls  residing  on  the  Job  Dispatch  Queue  for  the  job. 
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3.3.6  Job  Dispatch  Queues 

The  job  dispatch  queues  contain  calls  for  execution  of  the 
system  jobs.  Three  queues  are  currently  defined:  one  each  for  priority  1  jobs, 
priority  2  jobs,  and  priority  3  jobs  (Debug  only).  Each  CPU  bids  for  the  job 
dispatch  queues  and  executes  jobs  defined  therein.  Several  calls  to  the  same 
job  may  exist  at  one  time.  Suspended  jobs  may  be  executed  by  either  CPU, 
execution  vector  permitting.  Checkpointed  jobs  may  only  be  re-executed 
by  the  CPU  which  previously  executed  the  job.  A  CPU  will  idle  (cease 
execution  with  IDLE  instruction)  if  no  calls  exist  which  may  be  executed. 

This  is  done  to  eliminate  bus  contention  by  a  CPU  which  has  no  useful 
processing  to  perform. 

Job  calls  are  generated  when  a  job  is  called  by  another  job, 
when  a  previously  job  requested  event  has  completed,  or  by  operator 
command  via  the  console. 

Each  job  call  consists  of  a  three-word  entry  in  the 
appropriate  job  dispatch  queue.  The  first  word  defines  the  called  job's 
System  Job  List  address.  The  second  word  is  the  job  call  ID  which 
consists  of  a  one  byte  field  defining  the  caller  ID  and  a  one  byte  event 
code.  The  caller's  ID  equals  0  for  jobs  called  by  the  operating  system. 

It  defines  the  calling  job's  ID  for  interjob  calls.  The  event  code 
uniquely  defines  the  purpose  of  the  call.  The  third  word  is  data, 
typically  a  buffer  address.  When  a  job  is  reinitiated  from  the  point  of 
suspension,  the  Job  Call  ID  and  data  word  are  stored  respectively  in  the 
job's  registers  k2  and  k3. 

3.3.7  Job  Cl ock  Queue 

When  a  job  suspends  for  time,  an  entry  is  made  in  the  job 
clock  queue.  Each  clock  queue  entry  defines  the  job  ID  and  the  job 
specified  time  interval.  When  the  specified  time  interval  has  elapsed, 
the  job  is  called  by  the  operating  system.  The  entry  is  deleted  when 
the  job  is  called.  A  second  suspend  for  time  request  deletes  a  previous 
entry  for  the  job. 

The  clock  queue  contains  a  contention  flag  and  the  elapsed 
time  clock  value  when  the  queue  was  last  serviced.  Both  CPUs  service 
the  single  Job  Clock  Queue. 

3.3.8  Packet  Buffers 

The  operating  system  implements  eleven  packet  buffers  in  zone  3. 
tach  packet  buffer  consists  of  160  16-bit  words  as  illustrated  below: 

User  Space  ( 20  words) 

Packet  Assign/kelease  Flag  (1  word) 

Packet  Buffer  Queue  Chain  Address  (1  word) 

Packet  Preamble  (3  words) 

Packet  Header,  Text,  CRC,  1822  DMA  Status  (135  words) 
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The  User  Space  is  provided  for  temporary  buffer.  It  is 
further  defined  by  the  Radio/1822  DMA  I/O  routines.  The  Packet 
Assign/Release  Flag  specifies  if  the  packet  is  assigned  to  a  user.  The 
Packet  Queue  Chain  Address  contains  an  absolute  address  pointinq  to  the 
next  packet  buffer  in  the  circular  packet  buffer  queue.  The  Packet 

Preamble  contains  the  three  radio  transmitted  packet  preamble  words. 

One  hundred  thirty-five  words  are  provided  to  buffer  the  actual  packet 
header  and  text  (up  to  127  words),  CRC  checksum  (2  words),  and  1822  DMA 
status  (b  words). 


3.4  Processes 


3.4.1  Initial ization/BIT  Diagnostics 

Initialization  does  the  BIT  Diagnostics  and  initializes  the 
peripheral  hardware  and  the  operating  system.  It  consists  of  two  major 
parts,  power-up  initialization  and  restart  initialization,  each  of  which 
consists  of  several  sections.  Power-up  initialization  has  the  following 
sections:  3 


.  PROM  checksum  test 
.  RAM  test  with  incrementing  test  values 
.  RAM  test  with  decrementing  test  values 
.  Mapping  register  read  back  test 
.  Mapping  register  address  memory  test 
.  RAM  test/initialization  with  zero 
.  Bootstrap  load  and  checksum  generation/test 
Restart  initialization  has  the  following  sections: 


.  OS  initialization  and  checksum  tests 

.  US  initialization  and  jobs'  checksum  tests  (and  down-line  load, 
i f  warranted) 

.  Error  summary 

In  addition,  the  peripheral  hardware  is  cleared,  the  1822 
READY  line  is  set  low,  CPU  interrupts  are  cleared,  the  mapping  registers 
are  initialized,  and  the  zone  1  workspaces  are  initialized  as  a  result 
of  any  stimulus  that  causes  initialization. 
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The  sections  are  executed  in  the  order  listed,  with  power-up 
initialization  followed  by  restart  initialization.  Each  section  is 
executed  sequentially  by  each  CPU.  Both  CPUs  finish  execution  of  a 
section  before  either  begins  execution  of  the  next.  Both  CPUs  execute 
all  of  the  sections  except  bootstrap  load  and  checksum  generation/test, 
which  is  executed  by  only  the  first  CPU. 

Power-up  initialization  is  done  as  a  result  of  one  of  the 

followi ng: 


.  First  applying  power  to  the  Pk 

.  Pushing  the  INI T  button 

.  Executing  the  IN  console  command 

.  An  initialization  error  with  auto-restart  enabled 

.  An  operational  failure  with  auto-restart  and  down-line  load 
enabled 

Restart  initialization  is  done  following  power-up 
initialization.  After  restart  initialization  has  been  completed,  it  is 
redone  as  a  result  of  one  of  the  following  events: 


.  Restoring  power  after  having  been  off 
.  Pushing  the  RSET  button 
.  Executing  the  RS  console  command 

.  An  operational  failure  with  auto-restart  enabled  but  down-line 
load  disabled 


If  power  is  restored  or  the  RSET  button  is  pushed  during  the 
execution  of  initialization,  the  currently  executing  section  is 
restarted. 


3-4.1. 1  Description  of  Initialization  Sections 
Section  1 :  PROM  checksum  test 

Does  checksum  tests  of  the  PROM  portions 
of  the  operating  system. Testing  includes 
checking  for  the  absence  of  memory  parity 
errors  and  bus  time-out  errors  while 
accessing  the  checksummed  address  spaces. 
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Section  2:  RAM  test  with  Incrementing 
test~vaTues 

Tests  the  RAM  by  executing  the  following: 

1)  Writes  an  Incrementing  pattern  wherever 
RAM  Is  detected  from  bus  address  00000 
up  to  the  zone  4  boundary  using  the 
zone  1  bias  register,  followed  by  zone  4 
up  to  the  1/0  address  tags  using  the 
zone  4  bias  register. 

2)  Reads  back  from  the  RAM  In  the  same  order 
and  checks  for  the  correct  pattern  and  for 
the  absence  of  memory  parity  and  bus  time¬ 
out  errors. 

Section  3:  RAM  test  with  decrementing  test 
values 


Tests  the  RAM  by  executing  the  following: 

1)  Writes  a  decrementing  pattern  (the  Inverse 
of  that  used  In  the  Incrementing  RAM  test) 
wherever  RAM  Is  detected  from  bus  address 
00000  up  to  the  zone  4  boundary  using  the 

'rjy  zone  1  bias  register,  followed  by  zone  4 

up  to  the  1/0  address  tags  using  the  zone 
4  bias  register. 

2)  Reads  from  the  RAM  In  the  same  order  and 
checks  for  the  correct  pattern  and  for  the 
absence  of  memory  parity  and  bus  time-out 
errors. 

Section  4:  Mapping  register  read  back  test 

Tests  the  ability  of  the  mapping  registers 

to  be  loaded  and  read  correctly  by  executing 

the  following: 

1)  Writes  an  Incrementing  pattern,  using  the 
zone  1  bias  register,  at  every  256-word 
bus  address  outside  of  zone  4. 

2)  For  every  256-word  bus  address  where  there 
Is  RAM  present,  for  the  zones  3,  2,  and  1 
mapping  registers,  and  for  CPU  addresses 
A600  and  5800,  loads  and  reads  back  from 
each  bias  and  limit  register  and  checks 

/•u  that  It  i-eads  back  correctly. 
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Section  5:  Mapping  register  address  memory 
test 

Tests  the  ability  of  the  mapping  registers 
to  address  memory  correctly  by  executing  the 
following: 

1)  Writes  an  Incrementing  pattern,  using  the 
zone  1  bias  register,  at  every  256-word 
bus  address  outside  of  zone  4. 

2)  For  every  256-word  bus  address  where  there 
Is  HAM  present,  for  the  zones  3,  2,  and 

1  mapping  registers,  and  for  CPU  addresses 
A600  and  5800,  loads  the  bias  and  limit 
registers  appropriately ,  reads  the  memory 
location,  and  checks  for  the  correct 
pattern. 

Section  6:  RAM  test/1 nltlal Izatlon  with 
zero 

Tests/lnltlallzes  the  RAM  by  executing  the 
f  ol  1  owl  ng : 

1)  Writes  zero  wherever  RAM  1;,  detected  from 
bus  address  00000  up  to  the  zone  4 
boundary  using  the  zone  1  bias  register, 
followed  by  zone  4  up  to  the  1/0  address 
tags  using  the  zone  4  bias  register. 

2)  Reads  back  from  the  RAM  and  checks  for  zero 
and  for  the  absence  of  memory  parity  and 
bus  time-out  errors. 

Section  7:  Bootstrap  load  and  checksum 
generation/test 

Loads  the  non-resident  portions  of  the 
non-volatile  part  of  the  operating  system. 
Generates  the  checksum  value  for  each 
newly-loaded  portion  of  the  operating 
system  or  does  a  checksum  test  If  the 
checksum  value  was  loaded.  Testing 
Includes  checking  for  the  absence  of 
memory  parity  and  bus  time-out  errors 
while  accessing  the  checksummed  address 
spaces. 
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Section  8:  OS  initialization  end 
tests 

Does  a  parity  test  of  all  the  zone  4  RAM,, 

Does  checksum  tests  of  all  portions  of  the 

operating  system.  Testing  includes  checking 

for  the  absence  of  memory  parity  and  bus 

time-out  errors.  Initializes  the  CPU  state 

table,  the  job  dispatch  queues,  and  the  clock 

queue,  and  installs  the  Debug  job  and  Flap  job. 

Initializes  console  1/0  and  other  OS  zone  4  flags  and 

pointers. 

Section  9:  OS  initialization  and  .jobs1  checksum 
tests  (and  down-1  i ne  load,  if 
warranted )  " 

Does  a  parity  test  of  all  the  zone  4  RAM. 

Initializes  buffer  management  and  DMA  I/O 
flags  and  pointers.  Installs  the  interrupt 
and  XOP  vectors.  Sets  the  vector  indicating 
the  implemented  CPUs  and  initializes  the 
vector  indicating  the  enabled  CPUs.  Installs 
the  pointer  to  the  CPU  “job"  entry  in  the  system 
job  index.  Initializes  the  entries  and  does 
checksum  tests  of  the  resident  jobs  in  the  syster. 
job  list.  Checksum  testing  includes  checking  ior 
the  absence  of  memory  parity  and  bus  time-out 
errors  while  accessing  the  checksummed  address 
spaces.  If  no  joDS  except  Debug  and  Flap  are  resident, 
uoes  a  job  down-line  load,  providing  that  the 
auto-restart  and  down-line  load  switches  are  set. 

Section  F:  Error  Summary 

Displays  the  total  number  of  errors  during 
initialization  in  the  front  panel  data  LEDs, 
blinking  the  display  if  the  number 
is  non-zero. 

3. 4. 1.2  LED  Display  and  Error  Logging 

As  each  section  is  entered  by  each  CPU,  the  section  ID  is 
displayed  in  the  second  character  of  the  front  panel  code  LEDs,  the  CPU 
number  is  displayed  in  the  first  character  of  the  front  panel  data  LEDs, 
and  zeros  are  displayed  in  the  other  characters.  The  exception  is 
Section  F,  in  which  the  total  number  of  errors  is  displayed  in  all  4 
characters  of  the  data  LEDs. 
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Every  error  detected  in  the  diagnostic  tests  causes  an 
error  code  to  be  displayed  in  the  last  3  characters  of  the  front  panel 
data  LEDs  and  causes  the  whole  display  to  be  blinked.  After  an  error 
has  been  displayed  for  2  seconds,  execution  resumes  unless  certain 
hardware  switches  are  set.  If  the  auto-restart  switch  is  set,  power-up 
initialization  is  redone.  The  exception  is  when  there  has  been  a  load 
error,  in  which  case  the  down-line  load  switch,  as  well  as  the  auto¬ 
restart  switch,  must  be  set  in  order  for  power-up  initialization  to  be 
redone;  if  both  switches  are  not  set,  execution  stops  after  a  load 

error.  Special  initialization  mode  switches  cause  special  sequencing 
for  debug  purposes. 

3.4.2  Job  Control 

Several  processes  are  utilized  to  schedule,  monitor,  and 
control  job  execution  in  the  i’R.  These  are  listed  below: 


.  Job  Cal  1 

.  Job  Scheduler 

.  Interval  Ti mer/ Cl  ock  Queue 

.  CPU  Directed  Interrupt 

.  Failure  Interrupt  and  Unused  XOP/lnterrupt 

3.4.3  Job  Call 

The  job  call  process  is  invoked  via  user  XOP  or  operating 
system  BLWP  call.  It  generates  a  job  call  on  the  appropriate  job 
dispatch  queue  and  generates  a  CPU  directed  interrupt  to  all  enabled 
CPUs  to  define  the  existence  of  a  new  system  processing  task. 

Calls  to  execute  a  system  job  are  generated  by  the  operating 
system  as  a  result  of  the  following: 


.  Completion  of  an  event  previously  requested  by  the  job.  These 
include  Radio/1822  DMA  I/O,  console  i.-'put,  and  suspension  for 
time  interval  elapsed. 

.  Upon  request  from  another  system  job. 

.  Upon  request  from  the  operator  via  the  local  console  command  XJ 
(calls  all  idle  jobs). 

.  Upon  auto-restart  (calls  all  resident  jobs). 


A  job  call  is  defined  by  a  three-word  entry  in  the  job 
Dispatch  Queue  corresponding  to  the  job  execution  priority.  These  words 
consist  of  the  job's  System  Job  List  address,  Job  Call  lb,  and  data 
word.  Several  calls  of  the  same  jqb  may  exist  at  one  time.  The  Job 
Dispatch  Queue  data  structure  provides  the  service  of  message  sending  as 
well  as  job  scheduling. 

3. 4. 3.1  Job  Scheduler 

This  process  is  invoked  by  user  process  XOP  or  operating 
system  BLWP  call.  Its  task  is  to  save/restore  the  machine  state  of  the 
system  jobs  and  initiate  jobs  defined  in  the  job  dispatch  queues. 

Each  CPU  independently  examines  the  Job  Dispatch  Queues 
to  determine  if  jobs  are  to  be  executed.  The  queues  are  examined  in 
order  of  priority  (1,2,...).  Job  calls  in  each  queue  are  serviced  first 
in/first  out.  Preempted  (checkpointed)  jobs  are  re-executed  only  by  the 
CPU  which  last  executed  the  job.  Suspended  jobs  are  re-executed  by  either 
CPU.  Idle  jobs  (jobs  which  have  never  executed,  or  are  being  initialized)  are 
initialed  at  the  Initialization/Restart  PC.  Suspended  or  checkpointed  jobs  are 
always  reinitiated  at  the  point  execution  ceased  as  defined  by  the  job's 
current  ST,  PC,  WP  register  values  maintained  on  the  System  Job  List. 

If  no  job  calls  exist  which  may  be  serviced,  a  CPU  will 
go  idle  (execute  IDLE  instruction).  In  the  idle  state  no  bus  accesses 
are  made  by  the  CPU  which  eliminates  bus  contention  by  a  CPU  with  no 
useful  processing  to  perform.  A  CPU  leaves  the  idle  state  upon  the 
occurrence  of  any  hardware  interrupt. 

,  A  cplJ  deletes  the  Job  Dispatch  Queue  entry,  restores  the 

job  s  machine  state  and  initiates  the  job.  The  job  call  ID  and  data 
word  are  copied  from  the  Job  Dispatch  Queue  into  a  suspended  job's 
workspace  register  R2  and  R3. 

Ihi s  process  is  called  by  a  system  job  to  relinquish 

control  to  the  operating  system  upon  completion  of  a  processing  task. 

The  job  may: 


.  Suspend 
.  Suspend  for  Time 
.  Suspend  for  Time  Conditional 
.  Halt  (Fault) 

.  Checkpoint 
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Suspend  ceases  job  execution  until  recalled.  Suspend  for 
time  ceases  job  execution  until  job  specified  time  interval  elapses 
or  another  call  occurs.  Suspend  tor  time  conditional  is  suspend  if 
calls  exist  tor  the  job  on  the  Job  Dispatch  queue,  otherwise  suspend  for 
time.  Halt  is  utilized  when  the  job  detects  a  failure  which  prohibits 
continued  PR  operation.  Auto-restart  is  invoked  if  selected  via 
hardware  switch  or  I  PR  execution  is  halted.  Checkpoint  is  used  by  the 
operating  system  to  stop  job  execution  when  the  PR  is  halted.  It 

generates  a  job  call  which  is  placed  at  the  top  of  the  Job  Dispatch 
Queue. 


3. 4. 3. 2  Interval  Timer/Clock  Queue 

This  process  is  invoked  from  the  job  scheduler  or  via 
interval  timer  interrupt.  It  maintains  the  Job  Clock  Queue  which 
defines  the  job  and  time  intervals  remaining  before  job  recall.  The  job 
call  process  is  invoked  for  jobs  with  elapsed  time  intervals.  The  queue 
maintains  the  last  call  interval  for  each  system  job  utilizing  this 
capability. 


3. 4.3.3  CPU  Directed  Interrupt 

This  routine  is  invoked  via  interrupt  generated  by  either 
CPU.  The  interrupt  is  generated  by  the  job  call  process  or  when  the  PR 
is  being  halted.  If  the  PR  is  halted  (stand-alone  mode),  a  busy  job  is 
checkpointed  and/or  the  CPU  goes  idle.  In  normal  operation  an  idle  CPU 
enters  the  job  scheduler.  A  CPU  executing  a  job  disregards  the 
interrupt. 


3. 4. 3. 4  Failure  Interrupt/Unused  Interrupt  or  XOP 

This  process  is  invoked  via  failure  interrupt.  The 
interrupt  is  the  'esult  of  a  bus  timeout,  watch  dog  timer  elapsed, 
invalid  instruct!,.  code,  or  memory  parity  error  failure. 

All  unused  interrupt  and  XOP  vectors  invoke  the  failure 

interrupt  process.  The  job  scheduler  process  is  invoked  to  halt  the 
failed  PR. 


IT  a  failure  reoccurs  before  the  Operator  Control /Monitor 
(Debug)  job  may  report  the  failure  the  CPU  is  idled  with  interrupts 
disabled.  Failure  is  identified  by  front  panel  LED  display. 

3.4.4  Console  I/O 

Jhis  process  serves  as  the  interface  between  jobs  and  the 
local  (RS-232  I/O  Channel)  console.  Services  provided  to  the  system 
jobs  are  1  i sted  bel ow: 
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.  Assign/Release  Console 
.  Output  ASCII  Message 
.  Output(binary)  Data  as  ASCII  Message 
.  Request  ASCII  Message  Input 
.  Release  Input  Buffer 

The  assign/release  console  is  used  to  assign  the  console 
output  to  the  requesting  job  for  one  or  more  logically  connected  outputs 
and  subsequently  release  the  console  output  for  other  jobs.  Assign 
console  timeout  is  provided  to  prevent  lockout. 

Output  ASCII  message  outputs  an  ASCII  character  string 
terminated  by  tTX  (03). 

Output  binary  data  encodes  any  number  of  4  bit  binary  groups 
in  ASCII  hexadecimal  (0-9,  A-F)  and  outputs  the  string  preceded  and 
followed  by  a  single  space. 

Input  message  requests  are  queued.  Operator  input  directed  to 
a  job  requesting  input  is  buffered.  When  the  input  is  complete  the 
requesting  job  is  called  and  is  provided  with  the  input  buffer  address. 
Ihe  job  releases  the  input  buffer  after  processing  the  operator  input. 

Output  is  buffered  by  the  console  I/O  process.  Output  from 
different  jobs  is  separated  by  output  of  the  job  name  by  the  console 


The  console  I/O  routines  are  invoked  via  use  of  the  XOP 
instruction.  The  calling  job  passes  an  event  code,  and  possibly  an 
additional  parameter,  in  its  own  workspace.  The  linkage  provided  by  XOP 
allows  the  I/O  routines  to  non-destructively  read  those  parameters  from 
the  calling  job's  workspace. 

Console  I/O  is  interrupt  driven  in  normal  operation.  The  I/O 
interface  is  polled  when  the  PR  is  halted  (stand-alone  mode).  When 
halted  the  Operator  Control/Moni tor  job  utilizes  a  special  console  I/O 
interface  which  preempts  other  job  use  of  the  console. 

When  a  console  interrupt  occurs,  both  CPUs  (if  their 
interrupts  are  enabled)  enter  the  interrupt  handling  routine  and  compare 
their  execution  priority  with  the  other  CPU's  execution  priority.  If  a 
CPU's  priority  is  less  than,  or  equal  to,  the  other  CPU's  priority,  this 
CPU  will  immediately  bid  for  the  interrupt  contention  flag.  If  the  flag 
is  found  negative,  the  CPU  clears  the  global  and  local  interrupts, 
switches  to  a  common  zone  4  workspace,  and  services  the  interrupt.  If 
the  contention  flag  is  found  positive,  i.e.,  the  other  CPU  is  already 
servicing  the  interrupt,  the  interrupt  routine  is  exited.  If  a  CPU's 
priority  is  higher  than  the  other  CPU's  priority,  this  CPU  will  delay  20 
usee  before  bidding  for  the  contention  flag. 
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3.4.5  Radi  o/l 822  DMA  1/0 

The  DMA  1/0  routines  provide  the  following  services  for  Radio 
and  1822  receive  ( RX) /transmit  (TX): 


.  Initiate  a  DMA  I/O  event 

•  .  Service  completion  of  a  DMA  I/O  event 

•  Idle  a  previously  requested  DMA  I/O  event 
3. 4. 5.1  Radio/1822  DMA  1/0  Initiate 

®  Whenever  a  DMA  I/O  initiate  request  is  issued,  one  of  the 

following  operations  is  executed: 

1.  If  the  DMA  channel  is  not  currently  busy  with  a  previous  1/0 
request,  then  the  DMA  request  is  initiated. 

2.  If  the  DMA  channel  is  busy,  then  the  1/0  request  is  queued  and  will 
be  initiated  as  soon  as  the  channel  is  free. 

Using  the  information  passed  by  the  user  in  the  DMA 
Packet  Buffer  Overhead,  the  DMA  I/O  event  is  initiated  by  loadinq  the 
^  DMA  hardware  Word  Count,  Address,  and  Control  Registers. 

The  Radio  RX  control  parameters  enable  the  user  to  enable 
the  radio  receiver  hardware  in  the  following  modes  of  operation: 


g  .  Reception  of  packets  through  either  of  the  two  Radio  RX  DMA 

channels. 

.  Specifically  specify  one  of  the  two  RADIO  RX  DMA  channels  for 
reception  of  packets. 

•  .  Loop  test  of  the  receiver  interface  with  and  without  the  channel 

selector. 

The  Radio  TX  control  parameters  enable  the  user  to 
transmit  packets  with  the  following  options: 


•  • 


.  ALOHA  with  and  without  randomization. 

.  DISCIPLINED  ALOHA  with  and  without  randomization. 
.  Carrier  Sense  with  and  without  randomization. 
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.  Radio  turnaround  with  the  receiver  interface. 


.  Radio  turnaround  with  tne  receiver  interface  and  cnannel 
sel  ector . 

The  1822  RX  and  1  822  IX  control  parameters  allow  tne  user 
to  select  the  following  modes: 

External  reception  or  transmission  of  packets  over  tne  1822 
interface. 

.  Loop  test  of  the  1822  receiver  and  transmitter. 

3. 4. 5. 2  Rddio/1822  DMA  I/O  Service  Completion 

Completion  of  a  DMA  I/O  event  is  indicated  by  generation 
of  a  DMA  hardware  interrupt.  Completion  service  includes  clearing  the 
DMA  Hardware  interrupt  and  inputing  contents  of  tne  DMA  hardware  Word 
Count,  Address  and  Status  registers  into  the  DMA  Packet  Buffer  Overhead. 
At  this  point  the  DMA  I/O  queue  is  reviewed  for  further  I/O  initiate 
events. 


8. 4. 5. 3  Radio/1  822  DMA  I/O  Idle 

A  DMA  I/O  event  can  be  idled  any  time  it  has  been  queued, 
initiated  or  service  completed. 

3.4.0  Local /Down-Line  Load 

These  processes  provide  the  capability  to  load  and  load  verify 
relocatable  and  absolute  origin  TI  9900  object  code  and  data  into  the 
IPR.  The  object  may  be  input  via  the  console  I/O  channel  interface 
(normal y  from  TI  Silent  700  tape  cassettes)  or  via  the  IPR  radio  or  1822 
DMA  I/O  interfaces. 


The  loader  accepts  standard  TI  9900  assembler  object  format 
ASCII  encoded  records  with  the  addition  of  two  characters.  These  are 


( 3C 


the 

f il e,  and  a  _  _ .  _  _ _ 

network  load  service  to  delimit  the  down-line  load  object  file  via  radio 
or  1822. 


Lift)  character  immediately  preceding  the  first  record  of  a 
4  ( 2A|  g  )  i s  appended  to  the  end  of  a  load  file  by  the 

« j  4  z' «  +  -~*1  —  _  —  ^  xL.  ■ _  i  •  i  i  i  •  «  < 


ihe  first  origin  of  the  program  indicates  whether  the  program 
is  absolute  or  relocatable.  If  the  first  origin  is  non-zero,  the 
program  is  assumed  to  be  absolute.  If  the  first  origin  is  zero,  the 
program  is  assumed  to  be  a  rel  ocatabl  e  job.  If  the  program  is  a 
t  el  ocatabl  e  job,  t  fie  loader  will  check  the  system  job  index  to  determine 
if  me  job  has  previously  been  loaaed.  If  so,  the  incoming  program  will 
be  loaaed  over  the  previous  version.  Care  should  be  taken  that,  if  the 
new  version  of  an  existing  job  is  longer,  the  system  job  list  must  be 
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cleared  with  a  Terminate  Job  (TJ)  command  before  loading.  If  the  job 
does  not  already  exist,  the  loader  scans  the  system  job  list  until  it 
finds  an  mipty  entry.  Any  absolute  origin  data  in  the  relocatable  job 
will  be  relocated  into  the  system  job  list  entry.  It  is  not  necesary 
that  all  jobs  be  loaded  at  the  same  time. 

Relocatable  jobs  are  loaded  into  zone  2  and  are  placed  in 
consecutive  memory  locations.  Absolute  programs  may  be  loaded  anywhere. 
Load  verification  is  automatically  performed  by  writing  the  data  into 
memory  and  immediately  reading  it  back  to  ensure  its  proper  storage. 

Load  verification  may  be  performed  on  absolute  or  relocatable 
programs.  If  relocatable,  the  loader  obtains  the  bias  and  relocation 
displacement  for  that  job  from  its  system  job  list  entry.  The  loader 
does  not  verify  the  contents  of  a  job's  system  job  list  entry. 

The  loader  is  invoked  by  the  operating  system  if  auto-restart 
and  down-line  hardware  straps  are  enabled  or  by  the  Operator 
Control /Moni tor  dob  as  a  result  of  an  operator  command.  Loading  is 
permitted  only  in  the  PR  halted  (stand-alone)  mode. 

3 . 4 . 0 . 1  Local  Consol e  Load 

The  local  console  loader  accepts  input  from  the  PR  I/O 
channel  interface.  The  interface  is  polled  for  input  as  opposed  to 
normal  interrupt  driven  operation.  Operator  actions  and  load  errors  are 
defined  by  messages  output  to  the  console. 

3. 4. 6. 2  Down-line  Load 

The  down-line  load  accepts  the  ASCII  encoded  object 
contained  in  packets  received  via  the  1822  and  radio  DMA  I/O  interfaces. 
The  request  to  be  down-line  loaded  is  defined  by  the  Load  Request  ROP 
packet  periodically  transmitted  by  the  PR. 

The  IPR  transmits  the  Load  Request  ROP  every  five  seconds 
alternately  via  1822  and  radio.  The  Load  Request  ROP  is  transmitted  at 
full  power,  100  Kbit,  rate,  carrier  sense  channel  access,  at  the  RF 
frequency  specified  in  the  iPR  hardware  switches.  Once  the  load  begins 
Load  Request  ROP  transmissions  are  suspended  until  5  seconds  has  elapsed 
since  the  receipt  of  the  last  valid  Load  Data  Packet. 

The  Load  Data  Packet  may  be  received  via  1822  or  1UQ/400 
Knit  radio.  To  be  accepted  the  packet  must  be  received  correctly,  be  of 
the  Load  Data  type,  match  the  load  data  file  name  requested  and  be 
correctly  sequenced.  The  IPR  verifies  the  received  file  name  against 
what  is  stored  and,  if  it  matches,  stores  the  name  received.  The 
previous  name  stored  (or  requested)  may  be  a  shortened  version,  such  as 
the  default  case  ("ETX").  Subsequent  packets  must  match  the  earlier 
ones  in  file  name.  Additional  checks  are  made  on  the  load  data.  If 
load  data  text  errors  are  detected  the  down-line  load  is  aborted  with 
appropriate  local  error  display.  The  forme t  of  the  Load  Request  ROP 
packet  is  shown  in  Figure  9. 
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Once  loading  is  started,  the  IPR  will  only  accept  Load 
Data  PacKets  which  are  from  the  same  source  in  addition  to  having  the 
expected  file  name  and  sequence  number.  If  an  acceptable  Load  Data 
Packet  is  not  received  for  b  seconds,  the  IPR  will  begin  sending  Load 
Request  ROPs  and  will  accept  load  commencement  from  any  source  as  long 
as  the  conditions  of  file  name  and  sequence  number  are  met.  If  no 
acceptable  Load  Data  Packet  is  received  for  15  consecutive  Load  Request 
ROPs  (75  seconds),  t fie  IPR  will  declare  a  Load  Error  3  and  either  re¬ 
initialize  or  halt,  depending  on  the  states  of  the  auto-restart  and 
down-line  hardware  straps.  In  either  case  an  error  message  is  output  if 
a  console  is  attached. 

The  load  data  file  name  is  included  in  the  Load  Request 
ROP  for  two  reasons:  One,  the  IPR  will  indicate  the  request,  for  the  IPR 
OS  boot  load  and  network  protocol  load  as  separate  load  requests.  Two, 
cue  operator  may  request  via  local  console  command  the  loading  of  off¬ 
line  diagnostic  programs  as  well  as  protocol.  This  allows  a  simpler 
console  device  (keyboard,  printer,  no  load  capability)  to  be  used  for 
field  maintenance. 

The  error  data  provides  a  mechanism  for  the  return  of 
diagnostic  test  results  to  the  Network  Control  Center  (station).  This 
data  may  be  generated  by  IPR  BIT  diagnostics  and  by  the  remote  execution 
of  tne  off-line  diagnostics.  The  goal  is  to  provide  the  capability  for 
an  operator  at  the  NCC  (station)  to  execute  the  off-line  diagnostic 
programs  in  a  remote  network  IPR  and  obtain  the  summary  test  results. 

The  checksum  is  provided  for  a  hardware/software 
verification  which  is  performed  by  the  protocol  software. 

The  load  object  is  contained  in  Load  Data  Command 
Packets.  This  packet  format  is  shown  in  Figure  10. 

Load  data  ASCII  text  must  be  packed  in  tne  order  left 
hyte,  right  oyte,  in  consecutive  Load  Data  packet  text  words.  If  the 
load  data  is  an  odd  number  of  bytes  tne  last  byte  should  contain  a  NULL 
(00)  character.  Load  data  records  may  be  fragmented  into  more  than  one 
Load  Data  packet.  The  load  data  format  is  identical  to  that  loaded 
locally  via  tape  cassette  except  that  a  down-line  load  must  be 
terminated  by  the  character  (24-jg).  The  load  service  will  need  to 
append  this  Character  to  the  load  data  files  supplied  by  Rockwell  - 
Coll  ins. 


•  0 
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WORD 

DEFINITION 

1 

Hop  count,  header  length,  packet  length 

Bits  0-  3  = > Hop  count  =  0 

Bits  4-  7  =>  Header  length  =  B 

Bits  8-15  =>  Packet  length 

2-11 

Unused  header  words  all  set  to  zeros. 

12 

IPR  ID  from  hardware  switches 

13 

LROP  fl  ags 

Bit  0  =>  Label  oit 

Bit  1  =  >  Di stress  LROP 

Bit  2  =>Load  Request  bit 

Bi ts  3-4  =  >  PR  Type 

00  -  UPR 

01  -  IPR 

10  -  EPR 

11  -  LPR 

This  word  always  set  to  2800]  5. 

14 

Next  expected  Load  Data  Packet  sequence  number. 
Incrementing  count  with  initial  value  of  0000. 

15-18 

Load  data  file  name.  ASCII  character  string 
terminated  oy  ETX  (03).  Maximum  length  8  cnaracters. 
ETX  only  defines  request  for  latest  version  of  network 
protocol  .  The  IPR  OS  boot  load  file  name  is  11 IPR0S4 
ETX". 

19 

Left  byte  defines  IPR  job  ID  which  generated  error 
data  below.  Right  byte  is  binary  count  defining  length 
of  error  data  in  lo  bit  words. 

As  required 

Error  data. 

Last  word  Checksum. 


FIGURE  9  DOWN-LINE  LOAD  REQUEST  ROP  PACKET  FORMAT 
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WORD 


DEFINITION 


Header  The  IPR  down-line  loader  uses  the  following 

fields  of  the  packet  Header: 

!•  Bits  4-7  of  the  first  header  word  is  the 

packet  Header  length  and  is  used  to  locate  the 
start  of  the  packet  text. 

2.  Bits  8-15  of  the  first  header  word  is  tne 
packet  length  and  is  used  to  determine  the 
lengtn  of  the  load  data. 

3.  Bit  11  of  word  5  is  the  active  acknowledge 
(ACT)  Pit  and  is  set  when  transmitting  an 
active  acknowledgement  on  the  radio. 


Text  Word  1  The  upper  byte  of  the  first  text  word 

indicates  the  type  of  command  packet.  The  PR  Load 
Data  command  is  designated  by  a  30^  in  the  upper 
oyte  of  the  first  text  word.  The  lower  byte  of 
this  word  is  ignored. 

Text  Word  2  This  word  contains  the  ID  of  tne  PR  to  be 

1 oaded. 


Text  Word  3  Tnis  word  contains  the  Load  Data  packet's 

sequence  number.  The  sequence  number  of  the  first 
packet  in  the  load  is  0000,  and  each  subsequent 
load  data  packet  has  a  sequence  number  one  higher 
than  the  last  packet's  number. 

Text  Word  4  Beginning  in  this  word  is  the  name  of  the  file 

being  loaded.  The  name  is  an  ASCII  cnaracter 
string  terminated  by  an  ETX.  The  entire  string 
(including  the  ETX)  must  be  less  than,  or  equal 
to,  eight  characters  in  length. 

Remainder  of  text  Immediately  following  the  file  name's  ETX,  the 

IPR's  down-load  routines  begin  looking  for  the 
start  of  the  ASCII  load  data.  Null  (00)  bytes  are 
ignored  by  the  loader. 


FIGURE  10  DOWN-LINE  LOAD  DATA  COMMAND  PACKET  FORMAT 
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The  load  data  file  name  must  be  contained  in  every  Load 
Data  Packet.  This  name  Is  compared  with  the  name  In  the  Load  Request 
ROP.  They  must  be  equal  for  the  down-line  loader  to  accept  the  packet. 
However, If  the  Load  Request  ROP  load  data  file  name  is  ETX  only,  the 
loader  will  accept  any  load  data  file.  This  feature  Is  provided  to 
permit  a  remote  operator  to  load  and  execute  any  file  (off-line 
diagnostics  or  protocol). 

3.4.7  Buffer  Management 

The  operating  system  provides  eleven  packet  buffers  contained  In 
Zone  3  memory.  Each  packet  buffer  (described  in  Section  3.3.8)  contains 
an  overhead  area  for  system  software  use,  the  packet  preamble  for  radio 
transmissions  and  space  for  the  maximum  length  packet  (header,  text, 

CRC). 


The  packet  buffers  are  constructed  when  the  system  Is 
initialized.  Packet  buffers  are  allocated  to  users  upon  request  and  are 
released  by  users  when  no  longer  needed.  Packet  buffers  are  assigned 
and  released  via  appropriate  call  to  the  operating  system  utilizing  the 
extended  operation  (XOP)  Instruction. 

3.4.8  Util  1  ties 

Four  utility  processes  utilized  by  the  jobs  are  provided. 

They  are  Invoked  by  user  job  XOP. 

Une  process  updates  the  vector  indicating  the  enabled  CPUs 
and.  In  doing  so,  disables  operation  of  all  but  the  selected  CPU.  This 
enables  operation  of  a  single  CPU  for  testing  and  maintenance. 

The  second  process  provides  the  absolute  address  of  the  CPU 
Configuration  Table  to  permit  job  access  to  the  data  contained  therein. 

The  third  process  buffers  error  data  from  a  job  or  operating 
system  process  which  Is  subsequently  Included  In  Load  Request  ROP 
packets. 


i  The  fourth  process  displays  or  alters  locations  in  memory  to 
permit  remote  AM/DM  commands  via  Command  Packets 

3.4.9  I/O  TAG  Read/Write  Service 

This  process  provides  an  interface  between  the  user  joos  and 
various  hardware  functions.  This  process  is  Invoked  by  user  job  XOP. 

The  following  seven  functions  are  provided: 

Read  MS  word  of  elapsed  timer. 

Read  LS  word  of  elapsed  timer. 

Read  both  words  of  elapsed  timer. 

Reset  elapsed  timer. 
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Read  PR  ID  straps  latcn. 

Read  RAM  Image  of  MODE  straps  latch. 
Write  to  front  panel  CODE  and  DATA  LEDS. 


3.4.10  Operator  Control /Monitor  (DEBUG)  Job 

<4.,I!le+operdt1n9  S'ystem  provides  system  monitoring  and  control 
iCnraib11 1tlef  t0  ?,n  °Pe)"ator  v1a  command  Input  and  message  display  at  the 

nSal  enxlcuetionTS5S?hC/Pab!1U1^  are  “t111zed  *>  unitor  andP  control 
normal  execution  of  the  system  jobs  and  provide  necessary  tools  to 

support  system  software/hardware  debugging.  y  t00> s  to 

The  Operator  Control /Monl tor  job  Is  executed  as  any  other 

R1rh?i0!?tS0n,0f  the /?•  ^  executes  In  a  single  CPU 

w  ha]ted  (stand-alone  mode).  It  Is  invoked  upon  completion 
of  PR  Initialization,  when  the  PR  falls  or  a  software  trace  breakpoint 
Is  encountered.  It  may  be  invoked  by  operator  console  command  or  by 
another  system  job.  J 


The  functional  capabilities  provided  which 
operator  or  job  command  are  listed  below: 


are  selectable  via 


.  Terminate  Jobs  (TJ) 

.  Display  Memory  or  Peripheral  Interface  (DM) 
.  Alter  Memory  or  Peripheral  Interface  (AM) 

.  Display  Job  Registers  (DR) 

.  Invoke  Restart  Initial ization  (RS) 

.  Invoke  Power-Up  Initialization  (IN) 

.  Halt  Jobs  (HJ) 

.  Display  Job  Status  (DJ) 

.  Execute  Operator  Routine  (GO) 

.  Initiate  Execution  of  Jobs  (XJ) 

.  Alter  Job  Registers  (AR) 

.  Set  Software  Trace  Breakpoints  (ST) 

.  Clear  Software  Trace  Breakpoints  (CT) 

.  Down-Line  Load  (DL) 

.  Down-Line  Load  Verify  (DV) 


-42- 


I  PR  O.S.  Users  Guide 


June  30, 


.  Console  Load  (LD) 

.  Console  Load  Verify  (LV) 

3. b  Operational  Description 

3.5.1  lnl tial  ization 

Power-Up  Initialization  Is  Invoked  by  depression  of  the  INIT 
pushbutton,  by  operator  console  IN  command,  or  by  PR  failure  which 
warrants  power-up  Initialization.  Both  CPUs  participate  In  the 
Initialization  which  consists  of  several  BIT  diagnostic  tests,  loading 
of  the  remaining  portions  of  the  operating  system,  and  initialization  of 
the  operating  system  RAM.  Execution  of  each  segment  of  Initialization 
is  shown  in  the  front  panel  LED  display.  A  blinking  display  Identifies 
failure.  If  auto-restart  is  enabled,  a  failure  will  re-lnvoke  power-up 
Initialization.  Upon  completion  of  power-up  initialization,  restart 
Initialization  is  Invoked. 

Restart  initialization  Is  invoked  by  depression  of  the  RSET 
pushbutton,  by  operator  console  RS  command,  by  PR  operational  failure  if 
just  auto-restart  is  selected,  and  upon  completion  of  power-up 
initialization.  It  parity  checks  the  RAM  used  by  the  operating  system. 
It  checksum  verifies  operating  system  and  resident  job  code  space.  It 
Initializes  dynamic  OS  RAM  to  an  idle  (never  executed)  state.  If  no 
jobs  exist,  a  down-line  load  Is  requested  if  auto- restart  and  down-line 
load  are  enabled.  Execution  of  each  segment  of  initialization  Is  shown 
in  the  front  panel  LED  display.  A  blinking  display  Identifies  failure. 
If  auto-restart  is  enabled,  a  failure  will  invoke  power-up 
Initialization.  Upon  completion  of  restart  initialization  the  Operator 
Control /Monitor  (Debug)  job  is  executed  by  one  CPU. 

3.5.2  Stand-Alone  (Halted)  Operation 

Upon  completion  of  initialization  the  Operator  Control /Monitor 
job  Is  initiated  in  a  single  CPU  In  stand-alone  (PR  halted)  mode  of 
operation.  PR  halted  mode  is  also  invoked  when  a  PR  falls,  a  job  halts, 
a  software  trace  breakpoint  Is  encountered,  and  by  operator  IN,  RS,  HJ, 
and  TJ  console  commands,  and  depression  of  the  front  panel  INIT  and  RSET 
pushbuttons. 

Stand-Alone  (halted)  is  a  special  mode  of  operation  for 
operation  In  a  degraded  PR  for  testing  and  maintenance,  and  as  a 
transition  state  before  normal  operation  Is  Invoked.  In  stand-alone 
mode,  the  Debug  job  executes  Independently  of  the  normal  scheduler  In  a 
single  CPU  with  all  but  failure  interrupts  inhibited.  The  otner  CPU  Is 
idle  at  Interrupt  level  3.  All  other  job  execution  Is  Inhibited. 

Console  I/O  and  DMA  I/O  (for  down-line  loading)  are  used  in  a  polling 
non-interrupt  driven  mode.  Debug  execution  Is  Independent  of  any 
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previously  set  contention  flags  or  zone  1  contents  or  address  mapping, 

7nmi*°E?Me  °pe»:at0p, Input  Is  directed  to  Debug  job  via  a  dedicated 
Input  Duffer.  Console  output  preempts  and  Is  independent  of  any 
previously  queued  console  output.  All  operator  console  commands  are 


3.5.3  Normal  Operation 


Normal  operation  Is  Invoked  by  the  Debug  job  automatically  or 
via  operator  command.  If  auto-restart  Is  enabled  and  jobs  are  resident 
Debug  calls  all  Idle  or  halted  jobs  (auto  XJ  command) .  A  CPU  directed 
Interrupt  is  generated  to  all  enabled  CPUs.  Normal  operation  is  Invoked 
by  operator  XJ  console  command. 

In  normal  operation  both  CPUs  independently  execute  the 
operating  system  and  scheduled  system  jobs.  Operation  is  event  driven 
via  the  normal  scheduler.  Debug  operates  as  any  other  system  job.  Some 
Debug  operator  commands  are  not  valid. 
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4  JOB  DESCRIPTION 

The  applications  processes  of  the  PR  are  called  jobs.  The  PR 
operating  system  software  provides  forloaaing,  scheduling,  execution, 
and  on-line  debugging  of  the  system  jobs. 

The  network  protocol  processes,  off-line  diagnostic  processes,  and 
operator  control /monitor  (debug)  process  are  executed  as  system  jobs. 

4.1  Job  Structure 

A  job  is  partitioned  into  three  major  sections:  The  System  Job  List 
data,  Volatile  Local  Buffer  Space,  and  Non-Volatile  Instruction  Code 
Space.  This  Is  preceded  by  descriptive  comments  on  the  assembly 
listing.  Volatile  and  non-volatll  e  memory  space  are  separated  so  that 
instruction  space  may  be  placed  in  read  only  memory  (ROM).  This 
structure  in  assembler  syntax  Is  illustrated  in  Figure  11. 

The  job's  System  Job  List  is  the  data  which  follows  tne  absolute 
origin  statement  (AORG  >0).  Absolute  data  must  be  defined  as  shown. 

The  remaining  data  is  defined  as  follows.  Each  job  Is  assigned  a  unique 
five  ASCII  character  job  name,  and  a  unique  binary  encoded  job  ID.  All 
jobs  are  assigned  a  job  execution  priority.  At  present  two  are 
^  implemented;  priority  1  the  highest,  and  priority  2  the  lowest  priority. 
The  job  Initial  izati on/ restart  PL  defines  the  job  entry  PC  for  Initial 
execution  of  the  job.  All  jobs  are  in  memory  restartable.  Jobs  are 
required  to  load  (LWP1  instruction)  the  workspace  pointer  upon 
initialization.  The  jobs  ST,  PC,  WP  CPU  registers  define  normally  the 
job's  initial  status  (OOFjg),  Initial  izati  on/  restart  PC  and  initial 
workspace  pointer.  The  CPU  execution  vector  defines  which  PR  CPUs  may 
execute  the  job.  Each  bit  equal  to  one  defines  a  CPU  wnlcli  may  execute 
the  job.  The  bits  numbered  0-7  left-right  define  respectively  CPUs 
numbered  8-1.  Because  the  IPR's  dual  CPUs  are  numbered  1  and  2,  the 
normal  value  for  this  parameter  Is  03. 

The  beginning  of  the  job  address  space  is  designated  by  the 
relocatable  origin  (RORG  >  200)  statement.  Jobs  are  relocatably  loaded 
into  the  Zone  2  address  space.  Jobs  are  packed  contiguously  into* the 
Zone  2  address  space  by  appropriate  selection  of  a  bias  register  2  and 
relocation  displacement  for  each  job. 
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TITl  'job  title' 

IDT  'job  name' 

OPTION  XREF,0BJ 

* 

*  Description  of  Job's  Purpose  and  Scope 

*  Description  of  dob  Call  Event  Codes 


(if  any)  defined  by  Job 


*  System  Job  List  Data 

* 


AORG 

DATA 

TEXT 

BYTE 

BYTE 

BYTE 

DATA 

DATA 

DATA 

DATA 

DATA 

BYTE 

BYTE 

DATA 

DATA 

DATA 


>  0 

>  FFFF 
‘job  name' 

>  03 

>  job  ID 

>  priori ty 
1  abel 

>  n 

1  abel 
1  abel 

>  0 
>  0 

>  vector 
label 
label 
0 


Contention  Flag 
5  Character  ASCII  Name 
ASCII  Name  Delimiter 
Job  ID 

Job  Execution  Priority 
Job  Initial izati on/Restart  PC 
Job  CPU  ST  Register 
Job  CPU  PC  Register 
Job  CPU  WP  Register 
Job  Execution  State  (Idle) 
Executing  CPU  ID  (none) 

CPU  Execution  Vector 
Job  Checksum  Start  Address 
Job  Checksum  Stop  Address 
Job  Cnecksum  Datum 


Beginning  of  Volatile  Memory  Partition 


>  200 


(Volatile  data  buffers) 


Zone  2  Limit 


Beginning  of  Non-Volatile  Memory 
Partition  (Non-Volatile  instructions/data) 


FIGURE  11  JOB  STRUCTURE  IN  ASSEMBLY  LANGUAGE  SYNTAX 
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Jobs  are  created  in  the  I  PR  by  loading  via  the  local  I/O  cnannel 
(normally  from  magnetic  tape  cassette)  or  by  down-line  loading  via  the 
1823  or  radio  channels. 

Jobs  are  relocatably  loaded  into  Zone  2.  Tne  loader  selects  a 
System  Job  List  entry  arid  places  its  address  in  the  System  Job  Index. 
The  System  Job  List  entry  is  initialized  by  data  in  the  job  load  ana  by 
the  loader.  The  initial  execution  state  of  the  job  is  idle. 

4.3  Job  Execution 

Initial  job  execution  is  invoked  automatical ly  or  via  operator 
console  command  by  the  Operator  Control /Monitor  job.  Job  execution 
begins  at  the  initial  ization/restart  PC.  Jobs  are  required  to 
initialize  all  local  (internal)  buffer  space  appropriate  to  initial 
execution  of  the  job.  External  i nitial ization  is  performed  by  tne 
operating  system. 

Jobs  execute  to  perform  their  defined  tasks.  They  may  utilize  the 
resources  of  the  operating  system,  call  or  be  called  by  other  system 
jobs.  When  current  processing  tasks  are  completed  jobs  suspend  to  await 
subsequent  calls.  Execution  resumes  at  the  point  following  suspension. 
Jobs  may  be  non-concurrently  executed  by  several  CPUs  as  determined  by 
the  jod  s  CPU  execution  vector.  Jobs  may  execute  prior  to  suspension  up 
to  the  watch  dog  timer  internal  (approximately  2  seconds).  If  the  time 
interval  elapses  during  job  execution,  a  system  failure  is  declared. 

4-4  Job  Interfaces  to  the  Operating  System 

System  jobs  interface  with  the  operating  system  for  the  purposes  of 
controlling  the  job's  execution,  to  execute  processes  provided  by  the 
operating  system,  and  to  communicate  with  other  system  jobs.  These 
interfaces  are  implemented  with  the  extended  operation  (XOP) 
instruction.  Each  CPU  implements  sixteen  XOP  vectors  in  its  Zone  1 
memory  space.  Each  two  word  vector  consists  of  a  workspace  address 
followed  by  a  program  counter  (entry  address)  value.  Each  CPU  utilizes 
a  unique  workspace  (in  Zone  1  )  for  execution  of  the  operating  system 
process  (in  Zone  4).  Contention  is  resolved  with  the  ABS  instruction 
operating  on  process  contention  flags. 

The  general  format  of  the  XOP  call  to  the  operation  system  is  shown 
oelow: 


XOP  (Call  ID),  Vector  Name 
Return 


The  effective  address  specified  by  the  first  XOP  instruction 
operand  defines  the  location  of  the  Call  ID.  The  Call  ID  consists  of 
one  oyte  process  ID  (most  significant  byte),  and  one  byte  call  event 
code  (least  significant  byte).  The  process  ID  equals  00  for  operating 
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system  events.  It  equals  the  called  job's  ID  for  interjob  calls.  Each 
operating  system  event  is  assigned  a  unique  event  code  which  defines  the 
desired  event.  The  called  lob  defines  the  event  codes  for  interjob 
communication. 


The  vector  name  specifies  one  of  the  sixteen  XOP  vectors.  Current 
vector  assignments  and  associated  event  code  values  are  shown  below. 

Additional  linkage  information  is  required  for  some  calls.  This  is 
contained  in  the  calling  job's  workspace  registers. 

One  or  more  returns  from  the  XOP  call  may  be  defined.  Tne 
requested  event  may  be  processed  immediately,  in  some  cases  it  may  be 

queued  for  later  processing,  or  tne  XOP  may  specify  the  call  of  another 
job. 


in  some  cases,  a  requested  event  when  completed  generates  a  recall 
of  tne  job  wnich  originally  requested  the  event.  A  job  wnen  recalled 
from  the  point  of  suspension  determines  the  reason  for  the  call  by 
decoding  data  returned  to  its  workspace  registers  R2  and  R3. 

4.4.1  Job  Control 

The  job  control  calls  are  util  ized  by  tne  system  jobs  to 
temporarily  terminate  the  job's  execution.  Five  calls  are  provided. 


r  7 


Suspend  for  Time  Conditional  (SPNDTC) 
Checkpoint  (CKPT) 

Suspend  (SSPND) 

Suspend  for  Time  Interval  (SSPNDT) 
Halt  (HALT) 


< 


r< 


The  XOP  call  arguments  are  shown  below. 


JBCTRL 

EQU 

0 

CKPT 

DATA 

>  0005 

SSPND 

DATA 

>  0002 

SSPNDT 

DATA 

>  0003 

HALT 

DATA 

>  0004 

SPNDTC 

data 

>  0001 
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4. 4. 1.1  Job  Checkpoint 

This  call  is  utilized  by  the  operating  system  to  preempt 
execution  of  a  job.  A  system  job  may  utilize  this  call  to  temporarily 
terminate  execution  (watch  dog  timer  reset).  The  job  state  upon 
reinitiation  is  identical  to  the  job  state  prior  to  checkpoint.  Job 
call  event  codes  are  not  returned  to  the  job's  workspace.  The  operating 

system  generates  a  call  for  a  checkpointed  job.  The  call  is  illustrated 
bel  ow: 


XOP  @CKPT,dBCTRL 
Return  -  Job  Reinitiated 

4.4.1  .2  Job  Suspend 

This  call  is  used  by  the  system  jobs  to  temporarily 
suspend  execution  until  recalled.  The  job  is  recalled  at  the  point  of 
suspension  with  the  job  call  ID  and  data  word  stored  in  the  job's 
workspace  registers  R2  and  R3. 

The  job  call  ID  consists  of  tne  calling  job's  ID  or  the 
operating  system  ID  (00)  in  bits  0-7  and  the  call  event  code  in  bits  8- 
15  of  R2.  For  job  requested  events,  the  job  call  ID  (DMA  I/O,  terminal 
I/O  etc.)  equals  the  original  XOP  call  ID  value.  For  interjob  calls  it 
equals  a  job  defined  event  code  and  calling  job  ID. 

A  system  job,  upon  reinitiation  from  suspension  decodes 
the  event  code  to  determine  the  purpose  of  the  call.  The  data  word  (R3) 
further  defines  the  call.  R3  is  typically  a  buffer  address. 

The  call  is  illustrated  below: 

XOP  @SSPND, JBCTRL 

RETURN  -  JOB  RECALLED  WITH  R2,  R3  CONTAINING 
CALL  ID  AND  DATA 

4. 4. 1.3  Job  Suspend  for  Time  Interval 


This  call  provides  the  capability  for  a  job  to  reschedule 
its  execution  when  the  job  specified  time  interval  has  elapsed.  The  job 
is  recalled  when  the  time  has  elapsed  or  if  any  other  job  call  occurs. 

Job  call  due  to  time  interval  elapse  is  identified  by  the  SSPNDT  call  ID 
(vaiue  OOOo)  returned  in  the  job's  workspace  register  R2  Re-execution 
of  this  call  will  negate  a  previous  suspend  for  time  call,  unless  already 
queued  on  the  Job  Dispatch  Queue. 

The  call  time  interval  is  specified  by  the  content  of  the 
job's  workspace  register  R3.  The  interval  is  specified  by  a  binary 
count  iri  bits  1-15  of  R3.  R3  bit  0  (most  significant  bit)  defines  a 
scaling  factor.  If  bit  0  equals  0,  each  count  equals  1.657 
milliseconds.  If  bit  0  equals  1,  each  count  equals  42b  milliseconds. 
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The  call  Is  Illustrated  below: 

R3  =  TIME  INTERVAL 

XOP  OSSPNDT.JBCTRL 

RETURN  -  JOB  RECALLED  WITH  R2  CONTAINING  THE  CALL  ID 
AND  R3  CONTAINING  DATA 

4. 4. 1.4  Job  Suspend  for  Time  Conditional 

.  .  ,  Operation  is  equivalent  to  suspend  or  suspend  for  Time 

Interval .  Operation  is  suspend  if  the  job  is  scheduled  for  execution 
defined  by  calls  on  the  job  dispatch  queue.  Operation  is  suspend  for 
Time  Interval  if  the  job  execution  is  not  scheduled.  This  call  is 
utilized  to  eliminate  unnecessary  job  calls  due  to  time  interval 
processing  when  the  job  is  already  scheduled  for  execution. 

The  call  is  Illustrated  below: 

R3  =  TIME  INTERVAL 

XOP  OSPNDTC.JBCTRL 

RETURN  -  JOB  RECALLED  WITH  R2  CONTAINING  THE  CALL  ID 
AND  R3  CONTAINING  DATA 

4. 4. 1.5  Job  Hal  t 

Tnis  call  is  used  whenever  a  job  detects  a  failure  or 
't-r  abnormal  condition  which  precludes  continued  execution  of  the  job.  The 
operating  system  will  halt  system  job  execution  wnenever  a  failure  is 
detected.  These  include:  watch  dog  timer  elapsed,  memory  parity  error, 
bus  response  timeout,  Invalid  Instruction  operation  code,  and  software 
trace  breakpoint  trap. 

A  job  halt  (or  failure)  will  invoke  auto-restart 
initialization  and  the  operator  will  be  notified  via  local  console 
messages  with  job  execution  halted  until  restarted  by  the  operator 
depending  upon  the  auto-restart  hardware  strap. 

This  call  is  Illustrated  below: 

XOP  0HALT.JBCTRL 
4.4.2  CONSOLE  I/O 

Six  XOP  calls  are  provided.  These  are: 


.  Assign  Console  (ASGTRM) 

.  Release  Console  (RLSTRM) 

.  Release  Input  Buffer  (RLSIB) 
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Output  ASCII  Message  (MSGO) 

Output  Oata  as  ASCII  ( DATAO ) 

Request  ASCII  Message  Input  (MSGI) 

The  XOP  vector  name  and  event  code  values  are  shown  below: 


TRMIO 

EQU 

4 

ASGTRM 

DATA 

>  U040 

RLSTRM 

DATA 

>  0041 

RLSIB 

DATA 

>  0042 

MSGO 

DATA 

>  0043 

DATAO 

DATA 

>  0044 

MSGI 

DATA 

>  0045 

4. 4. 2.1  Assign  Consol e 

This  routine  dedicates  the  console  to  the  requesting  job. 
Assignment  should  be  used  if  several  logically  connected  output  requests 
will  be  made  and  intervening  outputs  by  other  jobs  are  not  desired.  The 
console  will  remain  in  the  assigned  state  until  the  assigning  job 
releases  the  console  with  a  call  to  RLSTRM,  or  until  the  assignment 
times  out,  i.e.  ,  the  assigning  job  has  not  made  any  output  request  for  a 
certain  period  of  time  and  another  job  has  requested  to  use  the  console. 

ASGTRM  has  two  returns.  The  first  return  indicates  the 
console  is  already  assigned  to  another  job.  The  second  return  indicates 
the  assignment  was  performed. 

To  assign  the  console: 

XOP  @ ASGTRM, TRM 10 

RETUrdl  -  CONSOLE  ALREADY  ASSIGNED  TO  ANOTHER  JOB 

RETURN+4  -  CONSOLE  ASSIGNMENT  PERFORMED 

4.4. 2.2  Rel  ease  Consol  e 

The  routine  is  used  to  release  an  assigned  console. 
Release  will  only  be  performed  for  the  job  to  which  the  console  is 
assigned. 

To  release  the  console: 

XOP  @RLSTRM,TRMIO 

RETURN  -  CONSOLE  RELEASED  OR  NO  ACTION 
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4 . 4 . 2 . 3  Rel ease  Input  Buff e r 

This  routine  releases  an  input  buffer  containing 
characters  previously  input  from  the  console.  Console  inpjt  is  stored 
in  a  buffer  in  zone  4  and  the  address  of  the  buffer  is  given  to  the  job 
receiving  input.  After  using  the  contents  of  the  buffer,  the  job  must 
release  the  buffer  for  future  console  input.  To  release  an  input 
buffer,  an  address  is  passed  in  register  R3  of  the  calling  job's 
workspace.  That  address  must  refer  to  some  location  within  the  input 

buffer.  The  address  passed  need  not  be  the  starting  address  of  the 
buffer. 


To  release  an  input  buffer: 

R3  =  ADDRESS  WITHIN  THE  INPUT  BUFFER 

XOP  @RLSIB ,TRMI0 

RETURN  -  INPUT  BUFFER  RELEASED 


n 


4. 4. 2. 4  Output  ASCII  Message 

Tin’s  routine  outputs  an  ASCII  character  string  to  the 
console.  The  character  string  must  be  stored  sequentially  in  memory  in 
asc?nding  addresses.  The  last  character  in  the  string  must  be  an  ASCII 
ETX  (03).  The  message  may  begin  or  end  on  an  even  or  odd  byte  boundary. 

The  calling  job  passes  the  address  of  the  start  of"  the 
v  -  message  in  register  R3.  MSGO  moves  the  character  string  into  a  transmit 
buffer  in  zone  4.  The  I/O  routines  saves  the  ID  of  the  last  job  to  have 
a  message  placed  in  the  transmit  buffer.  MSGO  places  the  message  "JOB 
YZ  (where  XYZ  is  tne  name  of  the  calling  job)  in  the  transmit  buffer 
between  messages  from  different  jobs. 


MSGO  has  two  returns.  The  first  return  indicates  the 
inability  to  move  the  messaye  into  the  transmit  buffer.  This  can  result 
from  the  console  being  assigned  to  another  job  or  from  the  transmit 
buffer  having  insufficient  space  to  hold  the  entire  message.  Upon 
b^ccessful  return  from  MSGO,  the  calling  job  may  reuse  its  own  message 

To  output  a  message: 


R3  =  STARTING  ADDRESS  OF  MESSAGE  CHARACTER  STRING 
XOP  0MSG0.TRMI0 

RETURN  -  UNABLE  TO  ACCEPT  OUTPUT 

•  RETURN+4  -  OUTPUT  ACCEPTED 

4. 4. 2. 5  Output  Data  as  ASCII  Message 

,  .  Tms  routine  encodes  a  specified  number  of  consecutive 

four  oit  binary  numbers  as  hexadecimal  ASCII  characters  and  outputs  the 

•  «  characters  to  the  console.  The  number  may  begin  or  end  on  even  or  odd 

byte  ooundaries.  The  nybbles  (nybble  =  4  bits  =  half  a  byte)  of  the 
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data  mjst  be  stored  sequentially  In  memory  with  Increasingly  significant 
bytes  being  stored  in  decreasing  addresses.  Two  parameters  must  be 
passed  to  DATAO.  Register  R3  must  contain  the  address  of  the  most 
significant  byte  of  the  number.  Register  R2  must  contain  the  number  of 
nybbles  In  the  number.  The  nyDble  count  may  be  any  nonzero  value.  If 
the  nybble  count  is  odd,  the  most  significant  nybble  must  be  right 
justified  In  the  byte. 

For  example,  suppose  It  Is  desired  to  output  the  number 
FU0B16,  wnlch  Is  stored  In  locations  0801 1 6,  080216,  and  0803io.  The 
number  would  be  stored  as  follows: 

0  1  2  3  4  5  6  7  8  9  10  11  12  13  14  15 

Memory  0800  XXXXXXXXXXXX1  1  1  1 

Address  0802  000100100011101  l 

Note  that  the  number  is  right  justified  and  leading  zeros 
are  not  required.  The  byte  at  location  0800  could  be  used  to  store  all , 
or  the  least  significant  portion  of  another  number.  The  job  wishing  to 
output  tnis  number  would  call  DATAO  with  the  address  0801  in  register  R3 
and  the  nybble  count  of  5  in  register  R2. 

DATAO  encodes  the  data  Into  hexadecimal  ASCII  characters 
and  moves  the  characters  Into  a  transmit  buffer  In  zone  4.  DATAO  also 
outputs  a  space  Immediately  preceding  and  following  the  number.  The  I/O 
routines  save  the  ID  of  the  last  job  to  have  a  message  placed  in  the 
transmit  buffer.  DATAO  places  the  message  "JOB  XYZ"  (where  XYZ  is  the 
name  of  the  calling  job)  in  the  transmit  buffer  between  messages  from 
different  jobs. 

DATAO  has  two  returns.  The  first  return  indicates  the 
Inability  to  move  the  decoded  data  Into  the  transmit  buffer.  This  can 
result  from  the  console  being  assigned  to  another  job  or  from  the 
transmit  buffer  having  Insufficient  space  to  hold  the  encoded  data. 

Upon  successful  return  from  DATAO,  the  calling  job  may  reuse  or  change 
the  numbers. 

To  output  data  as  ASCII  characters: 

R3  *  ADDRESS  OF  NUMBER'S  MOST  SIGNIFICANT  BYTE 

R2  =  NYBBLE  COUNT 

XOP  ©DATAO, TRM 10 

RETURN  -  UNABLE  TO  ACCEPT  OUTPUT 

RETURN+4  -  OUTPUT  ACCEPTED 

4. 4. 2. 6  Request  ASCII  Message  Input 

This  call  Indicates  the  willingness  of  the  calling  job  to 
accept  Input  from  the  console.  MSGI  maintains  a  list  of  those  jobs 
-  willing  to  accept  Input.  MSGI  stores  characters  input  from  the  console 

.f;  In  one  of  several  Input  buffers  In  zone  4.  Upon  completion  of  the  input 
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^  indicated  by  receipt  of  an  ETX  or  carriage  return)  the  job  receiving 
the  input  is  called.  After  the  job  call,  register  R3  will  contain  the 
starting  address  of  the  input  text  and  register  R2  will  contain  the 
value  004^  6 .  The  end  of  the  input  text  is  delimited  by  an  ETX. 

The  job  receiving  input  has  exclusive  use  of  the  input 
ouf  fe  r  until  it  has  completed  analyzing  the  input  text.  When  the  job  i 
longer  needs  the  input  text,  the  buffer  must  be  released. 

No  more  than  one  input  request  may  be  outstanding  from 
any  one  job.  Additional  requests  are  discarded.  An  input  request  is 
required  for  each  console  input. 

To  receive  input  from  the  console: 

XOP  6MSGI .TRMIO 

RETURN  -  INPUT  REQUEST  ACCEPTED 

AFTER  THE  JOB  CALL  OF  SUSPENDED  JOB 

R3  =  STARTING  ADDRESS  OF  INPUT  TEXT 

RE  =  U04b| 6 

4.4.3  Radio/1 822  DMA  I/O 

Twelve  DMA  I/O  functions  are  provided  via  XUP  call  as  shown 

bel  ow: 


.  Initiate  Radio  RX  Channel  1  or  2  DMA  I/O  (RDRXJ 
•  Initiate  Radio  RX  Channel  1  DMA  I/O  (RDRX1  ) 

.n  Li  ate  Kadio  RX  Channel  2  DMA  I/O  (RDRX2) 

.  Initiate  Radio  TX  DMA  I/O  ( RDTX ) 

.  Initiate  1822  RX  DMA  I/O  (STRX) 

.  Initiate  1822  TX  DMA  I/O  (STTX) 

.  Idle  Radio  RX  Channel  1  or  2  DMA  I/O  ( IRDRX) 

.  Idle  Radio  RX  Channel  1  DMA  I/O  (TRDRX1  ) 

.  Idle  Radio  RX  Channel  2  DMA  I/O  ( IRDRX2) 

.  Idle  Radio  TX  DMA  I/O  ( IRDTX ) 

.  Idle  1822  RX  DMA  I/O  (ISTRX) 

.  Idl  e  1822  TX  DMA  I/O  (ISTTX) 
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The  XOP  vector  name  and  event  codes  are  listed  below: 


DMAIO 

EQU 

5 

RDRX 

DATA 

>  0052 

RDRX1 

DATA 

>  0053 

RDRX  2 

DATA 

>  0054 

RDTX 

DATA 

>  0055 

STRX 

DATA 

>0050 

STTX 

DATA 

>  0051 

I  RDRX 

DATA 

>  005A 

IRDRX1 

DATA 

>  OQSB 

IRDRX2 

DATA 

>  005C 

IRDTX 

DATA 

>  005D 

I  STRX 

DATA 

>  0058 

I  STTX 

DATA 

>  0039 

Initiate 

Radio  RX 

DMA  I/O 

To  Initiate  a  Radio  RX,  the  user  must  first  secure  a 
packet  buffer  for  the  radio  transaction  and  then  Insert  the  Radio  RX  DMA 
control  parameter  In  the  IPR  DMA  I/O  Packet  Buffer  Overhead.  The  Radio 
RX  control  parameter  Is  Illustrated  In  Figure  12. 

After  the  packet  buffer  is  obtained  and  trie  control  word 
is  stored,  the  user  can  also  select  the  automatic  re-1 nltl ate  Radio  RX 
DMA  on  error  option  by  loading  the  Retry  Limit  byte  of  the  Retry  On 
'r+r  Error  register  In  the  DMA  I/O  Packet  Buffer  Overhead  with  a  value 
greater  than  zero.  The  ENABLE  (bit  15)  of  the  control  word  must  be 
zero.  At  tnls  point,  the  following  call  Is  used: 

R3  =  PACKET  BUFFER  ADDRESS  WHICH  WILL  CONTAIN  THE  DATA 
FROM  RADIO  RECEPTION 

•  XOP  0RDRX, DMAIO  FOR  RADIO  RX  CHANNEL  1  OR  2 

XOP  0RDRX1 .DMAIO  FOR  RADIO  RX  CHANNEL  1  ONLY 

XOP  0RDRX2, DMAIO  FOR  RADIO  RX  CHANNEL  2  ONLY 

RETURN  -  RADIO  RX  UMA  I/O  REQUEST  QUEUED  AND/OR  INITIATED 

1  he  Radio  RX  OMA  Word  Count  hardware  register  Is  loaded 
with  the  maximum  packet  length  of  129  words,  which  Includes  header  + 
text  +  2  CRC  words.  The  Radio  RX  DMA  Address  hardware  register  Is 
loaded  with  the  Radio  TX  DMA  I/O  packet  buffer  address  passed  In  R3. 

The  Radio  RX  DMA  Control  register,  which  is  located  In  the  DMA  I/O 
Packet  Buffer  Overhead,  Is  passed  to  the  Radio  RX  DMA  Control /'Status 
hardware  register  with  bit  15  (ENABLE)  set.  At  this  point  the  Radio  RX 
DMA  I/O  request  Is  Initiated. 
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BITS 

FUNCTION 

DEFINITION 

0-12 

Not  Used 

-- 

13 

TST  CHNL  SEL 

0  -  Normal  Operation 

1  -  Loop  Test  of  Receiver 
Interface  and  Channel 

Sel  ector 

14 

1ST  RX  I/F 

0  -  Normal  Operation 

1  -  Loop  test  of  RX  interface 

• 

15 

ENABLE 

0  -  DMA  disabled 

1  -  DMA  enabled 


M 


FIGURE  13  RADIO  RX  CONTROL  WORD 


•  0 
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Once  the  Radio  RX  DMA  hardware  Interface  generates  an 
Interrupt,  the  contents  of  the  final  Word  Count,  Address  arid 
Control /Status  hardware  registers  are  saved  In  the  IPR  DMA  I/O  Packet 
Buffer  Overhead.  Since  the  value  of  the  Radio  RX  DMA  Word  Count 
hardware  register  Is  decremented  during  the  reception  of  data  from  the 
Radio  Unit  of  the  PR  to  the  Digital  Unit,  a  value  of  129  minus  the 
lenyth  of  the  received  packet  at  the  time  of  the  Interrupt  would 
Indicate  a  successfully  complete  Radio  RX  DMA  reception.  The  Radio  RX 
UMA  Address  hardware  register  will  contain  the  value  of  the  last  address 
+2  written  at  the  time  of  completion.  The  Radio  RX  DMA  Status  word  Is 
described  In  Figure  13. 

If  the  Radio  RX  DMA  Control /Status  hardware  register 
Indicates  that  the  DMA  transaction  had  error(s),  or  If  the  DMA 
transaction  did  not  fully  complete  (length  of  received  packet  is  not 
equal  to  packet  length);  the  Error  Count  byte  of  the  DMA  Retry  on  Error 
register  in  the  DMA  I/O  Packet  Buffer  Overhead  Is  incremented.  If  this 
Error  Count  is  less  than  or  equal  to  the  Retry  Limit  byte  of  the  Retry 
on  Error  register,  the  Radio  RX  DMA  I/O  request  Is  re-initiated.  If 
there  are  no  error(s)  or  the  Error  Count  Is  greater  than  the  Retry  Limit 
a  JOB  CALL  RETURN  is  then  issued  to  the  job  which  Initiated  the  Radio  RX 
DMA  I/O  request.  The  job's  workspace  registers  will  be  loaded  with  the 
following  Information  at  the  time  of  the  call: 

R2  =  RADIO  RX  DMA  I/O  EVENT  CODE 

(SAME  AS  USED  IN  INITIATE  CALL) 

R3  =  PACKET  BUFFER  ADDRESS  WHICH  CONTAINS 

THE  RECEIVED  PACKET 

4. 4.3. 2  Initiate  Radio  TX  DMA  I/O 

To  Initiate  a  Radio  TX,  the  user  must  first  secure  a 
packet  buffer  for  the  radio  transaction  and  then  Insert  the  Radio  TX  DMA 
control  parameter  In  the  IPR  DMA  I/O  Packet  Buffer  Overhead.  The  Radio 
TX  control  parameter  Is  Illustrated  In  Figure  14. 

After  the  packet  buffer  Is  obtained  and  the  control  word 
Is  stored,  the  user  can  also  select  the  automatic  re-initiate  Radio  TX 
DMA  on  error  option  by  loading  the  Retry  Limit  byte  of  the  Retry  on 
Error  register  in  the  DMA  I/O  Packet  Buffer  Overhead  with  a  value 
greater  than  zero.  The  ENABLE  (bit  15)  of  the  control  word  must  be 
zero.  At  this  point,  the  following  call  Is  used: 

R3  *  PACKET  BUFFER  ADDRESS  WHICH  CONTAINS  THE  DATA 
FOR  THE  RADIO  TRANSMISSION 
XOP  0RDTX.DMAIO 

RETURN  -  RADIO  TX  DMA  I/O  REQUEST  QUEUED  AND/OR  INITIATED 
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BITS 

FUNCTION 

DEFINITION 

0-4 

Not  used 

5 

CHANNEL  SEL 

0  =  >  Channel  A 

1  =>  Channel  B 

5 

RX  TERM 

Radio  RX  tenninated  due 
to  radio  TX 

7 

EOP  SYNC 

Received  EOP 

8 

HIGH  DATA  RATE 

0  =  >  1  00  Kbi t/sec 

1  =  >  400  KDi t/sec 

9 

OVERRUN  ERROR 

Memory  overrun  error 

1  0 

SYNC  ERROR 

Loss  of  EOP  error 

11 

CRC  ERROR 

Checksum  error 

1  2 

MEMORY  ERROR 

Memory  parity  error  and/or 
DMA  bus  time-out  error 

13 

WO  C.iUNT  ERROR 

Incorrect  word  count  loaded 
into  DMA  word  count  regist< 

14 

DONE 

DMA  operation  completed 

1  5 

ENABLE 

Image  of  radio  RX  DMA 

ENABLE  control  bit 

FIGURE  13  RADIO  RX  STATUS  WORD 
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FUNCTION 

DEFINITION 

0-5 

FREQ  CTRL 

Image  of  RF  frequency  bits 
defined  in  Section  2.11  .1 .4 

6 

TX  RANDOMIZE 

0  = > Non  Randomize  Radio  TX 
1  =>Ranaomize  radio  TX 

7 

DISC  ALOHA 

0  =  >  A1  oha 

1  =>  Disc i pi  ined  Aloha 

8 

HIGH  DATA  RATE 

0  =  >  1  00  Kbi t/sec 

1  =  >  400  Kbi t/sec 

9-11 

RF  POWER 

111  =>Full  power 

110  =  >  -5  dB 

1  01  =>-10  dB 

Oil  =>  -15  dB 

001  =>  -°0  dB 

1 2 

ENABLE  RX 

0  =  >  Di sabl  e  radio  RX 

1  =  >  Enabl  e  radio  RX 

13 

TX  CS  MODE 

0  =  >  A1 oha  modes 

1  =>  Carrier  sense  modes 

14 

TEST 

0  =>  Normal  operation 

1  =  >  Loop  test 

15 

ENABLE 

0  =  >  DMA  di sabl ed 

1  =  >  DMA  enabl ed 

FIGURE  14  RADIO  TX  CONTROL  WORD 
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The  Radio  TX  DMA  Control  register,  which  is  located  iri 
the  DMA  I/O  Packet  Buffer  Overhead,  is  passed  to  the  Radio  TX  DMA 
control  /Status  hardware  register  140  microseconds  before  bit  15  (ENABLE) 
is  set.  This  allows  the  RF  hardware  to  set  the  frequency,  data  rate  and 
power  level  before  the  DMA  is  initiated.  The  contents  of  the  Radio  TX 
Randomization  Time  register  in  the  DMA  I/O  Packet  Buffer  Overhead  is 
loaded  into  the  Radio  TX  Randomize  hardware  register.  The  Radio  TX  DMA 
Word  Count  hardware  is  loaded  with  the  value  obtained  in  the  least 
significant  byte  of  the  first  word  of  the  header  +  3  words  to  include 
the  preamble.  The  Radio  TX  DMA  Address  hardware  register  is  loaded  with 
the  Radio  RX  DMA  I;  0  packet  buffer  address  -  3  to  include  the 
transmission  of  the  preamble  along  with  the  header  and  text.  At  this 
point  the  Radio  TX  DMA  Control  register  is  passed  to  the  hardware  with 
the  ENABLE  bit  set  --  the  Radio  TX  DMA  I/O  request  is  now  initiated. 


Once  the  Radio  TX  DMA  hardware  interface  generates  an 
interrupt,  the  contents  of  the  final  Word  Count,  Address  and 
Corrcrol /Status  hardware  registers  are  saved  in  the  IPR  DMA  I/O  Packet 
Buffer  Overhead.  Since  the  value  of  the  Radio  TX  DMa  Word  Count 
hardware  register  is  decremented  during  the  transmission  of  data  from 
the  Digital  Unit  of  tne  PR  to  the  Radio  Unit,  a  value  of  zero  at  the 
time  of  the  interrupt  would  indicate  a  successfully  complete  Radio  TX 
DMA  transmission.  The  Radio  TX  DMA  Address  hardware  register  will 
contain  the  value  of  the  last  address  +  2  read  at  the  time  of 
completion.  The  Radio  TX  DMA  Status  word  is  described  in  Figure  lb. 

If  the  Radio  TX  DMA  Control /Status  hardware  register 
indicates  that  the  DMA  transaction  had  error(s),  or  if  the  DMA 
transaction  did  not  fully  complete  (length  of  transmitted  packet  is  not 
equal  to  packet  length);  thj  Error  Count  byte  of  the  DMA  Retry  on  Error 
register  in  the  DMA  I/O  Packet  Buffer  Overhead  is  incremented.  If  this 
error  count  is  less  than  or  equal  to  the  Retry  Limit  byte  of  the  Retry 
on  Error  register,  the  Radio  TX  DMA  I/O  request  is  re-initiated.  If 
there  are  no  error(s)  or  the  Error  Count  is  greater  than  the  Retry  Limit 
a  JOB  CALL  RETURN  is  then  issued  to  the  job  which  initiated  the  Radio  TX 
DMA  I/O  request.  The  Job's  workspace  registers  will  be  loaded  with  th » 
following  inflation  at  the  time  of  the  call  : 

R2  =  ADIO  TX  DMA  I/O  EVENT  CODE 

(SAME  AS  USED  IN  INITIATE  CALL) 

R3  =  PACKET  BUFFER  ADDRESS  WHICH  CONTAINS 
THE  TRANSMITTED  PACKET 
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BITS 

FUNCTION 

DEFINITION 

O-IU 

Not  used 

1  1 

OVERRUN  ERROR 

Memory  overrun  error 

12 

MEMORY  ERROR 

Memory  parity  and/or  DMA 
bus  time-out  error 

13 

Not  used 

14 

DONE 

DMA  operation  completed 

15 

ENABLE 

Image  of  radio  TX  DMA 
enable  control  bit 

FIGURE  15  RADIO  TX  STATUS  WORD 
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4.4.J.3  Initiate  1822  RX  DMA  I/O 

To  initiate  an  1822  RX,  the  user  must  first  secure  a 
,,  packet  buffer  for  the  station  transaction  and  then  insert  the  1822  RX 

DfiA  control  parameter  in  the  IPR  Dm  I/O  Packet  Buffer  Overhead.  The 
1822  RX  control  parameter  is  illustrated  in  Figure  16. 

After  the  packet  buffer  is  obtained  and  the  control  word 
is  stored,  the  user  can  also  select  the  automatic  re-initiate  1822  RX 
rs  OMA  on  error  option  by  loading  the  Retry  Limit  byte  of  the  Retry  on 

m  Error  register  in  the  DMA  I/O  Packet  Buffer  Overhead  with  a  value 

greater  than  zero.  The  ENABLE  (bit  15)  of  the  control  word  must  be 
zero.  At  this  point,  the  following  call  is  used: 

R3  =  PACKET  BUFFER  ADDRESS  WHICH  WiLL  CONTAIN  THE  DATA 
J  FROM  THE  STATION  RECEPTION 

"  XOP  @STRX,0MAI0 

RETURN  -  1822  RX  Dm  I/O  REQUEST  QUEUED  AND/OR  INITIATED 
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BITS 

FUNCTION 

DEFINITION 

0-13 

Not  used 

14 

TEST 

0  =>  Normal  operation 
1  =  >  Loop  test 

1  5 

ENABLE 

0  =  >  DMA  di  sabl  ed 

1  =  >  DMA  enabl  ed 

m 


FIGURE  lb  1822  RX  CONTROL  WORD 
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The  1822  RX  DMA  Word  Count  hardware  register  is  loaded 
with  the  maximum  packet  length  of  129  words,  which  includes  header  + 
text  +  2  CkC  words.  The  1822  RX  DMA  Address  hardware  register  is  loaded 
with  the  1822  TX  DMA  i/0  packet  buffer  address  passed  in  R3.  The  1822 
RX  DMA  Control  register,  which  is  located  in  the  DMA  I/O  Packet  Buffer 
Overhead,  is  passed  to  the  1822  RX  DMA  Control/Status  hardware  register 

with  bit  15  (ENABLE)  set.  At  this  point  the  1822  RX  DMA  I/O  request  is 
initiated. 

Once  the  1822  RX  DMA  hardware  interface  generates  an 
interrupt,  the  contents  of  the  final  Word  Count,  Address  and 
Control /Status  hardware  registers  are  saved  in  the  IPR  DMA  I/O  Packet 
Buffer  Overhead.  Since  the  value  of  the  1822  RX  DMA  Word  Count  hardware 
register  is  decremented  during  the  reception  of  data  from  the  station  to 
the  Digital  Unit  of  the  PR,  a  value  of  129  minus  the  length  of  the 
received  packet  at  the  time  of  the  interrupt  would  indicate  a 
successfully  complete  1822  RX  DMA  reception.  The  1822  RX  DMA  Address 
hardware  register  will  contain  the  value  of  the  last  address  +  2  written 

at  the  time  of  completion.  The  1822  RX  DMA  Status  word  is  described  in 
Figure  17. 

IT  The  1822  RX  DMA  Control/Status  hardware  register 
indicates  that  the  DMA  operation  had  error(s),  or  if  the  DMA  transaction 
did  not  fully  complete  (length  of  received  packet  is  not  equal  to  packet 
length) ,  the  Error  Control  byte  of  the  DMA  Retry  on  Error  register  in 
the  DMA  I/O  packet  buffer  overhead  is  incremented.  If  the  Host  Ready  bit  is 
\7  set  (HOST  READY),  then  che  flap  routine  is  initiated  (PR  RDY  bit  of  the  1822 
TX  DMA  control  word  is  cleared  and  set,  with  a  delay  of  one  second  between 
these  operations)  and  processing  continues.  If  this  error  count  is  less  than 
or  equal  to  tne  retry  limit  byte  of  the  retry  o.i  error  register,  the  1822  RX 
DMA  I/O  request  is  re- i ni ti al i zed.  [f  there  are  no  error(s)  or  the  error 
count  is  greater  than  the  retry  limit  a  JOB  CALL  RETURN  is  immediately  issued 
to  cue  job  which  initiated  the  1822  RX  DMA  I/O  request.  The  job's  worxspace 
registers  will  be  loaded  with  the  following  information  at  the  time  of  the 
cal  1 ; 

R2  =  1822  RX  DMA  I/O  EVENT  CODE 

(SAME  AS  USED  IN  INITIATE  CALL) 

R3  =  PACKET  BUFFER  ADDRESS  WHICH  CONTAINS 
THE  RECEIVED  PACKET 
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BITS 

i- UNCTION 

DEFINITION 

0-5 

Not  used 

6 

LAST  BIT  ERROR 

Last  bit  did  not  occur  on 
a  16-bit  word  boundary 

7 

Not  used 

8 

HOST  READY 

Host  ready 

9 

Not  used 

10 

READY  DROPPED 

Host  ready  dropped 

11 

cRC  ERROR 

Checksum  error 

12 

MEMORY  ERROR 

Memory  parity  and/or  DMA 
bus  time-out  error 

18 

WORD  COUNT  ERR 

Incorrect  word  count  loaded 
into  DMA  word  count  register 

14 

DONE 

DMA  operation  completed 

15 

ENABLE 

Image  of  1822  RX  DMA  enable 
control  bi t 

FIGURE  1 7 
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4. 4. o. 4  Initiate  182c  TX  DMA  I/O 

Before  initiating  an  1822  TX,  the  user  should  verify  the  ready 
condition  of  the  1822  interface.  The  PR  RDY/STA  RDY  can  be  checked  using  the 
STIO  XOP  as  described  in  Section  4.4.3.10.  1  822  TX  initiation  should  be 

delayed  until  the  interface  is  ready. 

To  initiate  an  1  822  TX,  the  user  must  first  secure  a 
packet  buffer  for  the  station  transaction  and  then  insert  the  1822  TX 
DMA  control  parameter  in  the  IPR  DMA  I/O  Packet  Buffer  overhead.  The 
1822  TX  control  parameter  is  illustrated  in  Figure  18. 

Aftew'  the  packet  buffer  is  obtained  and  the  control  word 
is  stored,  the  user  can  also  select  the  automatic  re-initiate  1822  TX 
DMA  on  error  option  by  loading  the  Retry  Limit  byte  of  the  Retry  on 
Error  register  in  the  DMA  I/O  Packet  Buffer  Overhead  with  a  value 
greater  than  zero.  The  ENABLE  (bit  15)  of  the  control  word  must  be 
zero.  At  this  point  the  following  call  is  used: 

R3  =  PACKET  BUFFER  ADDRESS  WHICH  CONTAINS  THE  DATA 
FOR  THE  STATION  TRANSMISSION 

XOP  @STTX,DMAIO 

RETURN  -  1822  TX  DMA  I/O  REQUEST  QUEUED  AND/OR  INITIATED 

The  1822  TX  DMA  Word  Count  hardware  register  is  loaded 
with  the  value  obtained  in  the  least  significant  byte  of  the  first  word 
of  the  header  +  3  words  to  include  the  preamble.  The  1822  TX  DMA 
Address  hardware  register  is  loaded  with  the  1822  TX  DMA  I/O  packet 
Duffer  address  -  3  to  include  the  transmission  of  the  preamble  along 
with  the  header  and  text.  The  1822  TX  Control  register,  wnich  is 
located  in  the  DMA  I/O  Packet  Buffer  Overhead,  is  examined.  If  the  TEST 
bit  is  not  set,  indicating  normal  1822  operation,  the  PR  RDY  bit  is  set. 

At  this  point,  the  1822  TX  DMA  Control  register  is  passed  to  the  hardware 
with  the  ENABLE  bit  set  --  the  1822  TX  DMA  I/O  request  is  now  initiated. 

Once  the  1822  TX  DMA  hardware  interface  generates  an 
interrupt,  the  contents  of  the  final  Word  Count,  Address  and 
Control /Status  hardware  registers  are  saved  in  the  IPR  DMA  I/O  Packet 
Buffer  Overhead.  Since  the  value  of  the  1  822  TX  DMA  Word  Count  hardware 
register  is  decremented  during  the  transmission  of  data  from  the  Digital 
Unit  of  the  PR  to  the  station,  a  value  of  zero  at  the  time  of  the 
interrupt  woul  d  indicate  a  successfully  complete  1822  TX  DMA 
transmission.  The  1822  TX  DMA  Address  hardware  register  will  contain 
the  vaiue  of  the  last  address  +  2  read  at  the  time  of  completion.  The 
1  822  TX  DMA  Status  word  is  described  in  Figure  19. 


BITS 

FUNCTION 

DEFINITION 

0-1 1 

Not  used 

13 

PR  READY 

0  =  >  PR  not  ready 

1  =  >  PR  ready 

14 

TEST 

0  =  >  Normal  operati 
1  - >  Loop  test 

15 

ENABLE 

0  =  >  DMA  di  sabl  ed 

1  =  > DMA  enabl  ed 

FIGURE  18  1822  TX  CONTROL  WORD 
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BITS 

FUNCT  liil 

DEFINITION 

0-7 

Not  used 

8 

HOST  READY 

Host  ready 

9 

IMP  READY 

Ready  for  IMP  bit 

10 

Not  used 

11 

TX  RDY  ERROR 

While  transmitting  a  pkt, 
the  host  ready  dropped 

12 

MEMORY  ERROR 

Memory  parity  ^.nd/or  DMA 
bus  time-out  error 

13 

Not  used 

14 

DONE 

DMA  operation  completed 

15 

ENABLE 

Image  of  1822  TX  DMA 
enable  control  bit 

S' 


FIGURE  19  1 82c  TX  STATUS  WORD 
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If  the  1822  TX  DMA  Con Lrol /Status  hardware  register 
indicates  that  the  DMA  transaction  had  error(s),  or  if  the  DMA 
transaction  did  not  fully  complete  (length  of  transmitted  packet  is  not 
equal  to  packet  length),  the  Error  Count  byte  of  the  DMA  Retry  On  Error 
register  in  the  DMA  I/O  Packet  Buffer  Overhead  is  incremented.  If  the 
Host  Ready  bit  is  set  (HOST  READY),  then  the  flap  routine  is  initiated  (PR  RDY 
Dit  of  the  1822  TX  DMA  Control  word  is  cleared  and  set,  with  a  delay  of  one 
second  between  these  operations)  and  processing  continues.  If  this  Error 
Count  is  less  than  or  equal  to  the  Retry  Limit  byte  of  the  Retry  on  Error 
register,  the  1822  TX  DMA  I/O  request  is  re-initiated.  If  there  are  no 
error(s)  or  the  Error  Count  is  greater  than  the  Retry  Limit  a  JOB  CALL  RETURN 
is  immediately  issued  to  the  job  which  initiated  the  1822  TX  DMA  I/O  request. 
The  job  s  workspace  registers  will  be  loaded  with  the  following  information  at 
the  time  of  the  cal  1 : 

R2  =  1822  TX  DMA  1/0  EVENT  CODE 

(SAME  AS  USED  IN  INITIATE  CALL) 

R3  =  PACKET  BUFFER  ADDRESS  WHICH  CONTAINS 
THE  TRANSMITTED  PACKET 

4. 4. 3. 5  Idle  Radio  RX  DMA  I/O 

To  idle  a  previously  initiated  Radio  RX  DMA,  the 
following  call  is  used: 

R3  =  PACKET  BUFFER  ADDRESS  OF  RADIO  RX  DMA  TO  BE  IDLED 
XOP  eiRDRX.DHAIO  FOR  RADIO  RX  CHANNEL  1  OR  2 
XOP  0IRDRX1 ,DMA10  FOR  RADIO  RX  CHANNEL  1  ONLY 
XOP  @IRDRX2,DMAI0  FOR  RADIO  RX  CHANNEL  2  ONLY 
RETURN  -  RADIO  RX  DMA  I/O  REQUEST  IDLED 

4.4. 3. 6  Idle  Radio  TX  DMA  I/O 


To  idle  a  previously  initiated  Radio  TX  DMA,  the 
following  call  is  used: 

R3  -  PACKET  BUFFER  ADDRESS  OF  RADIO  TX  DMA  TO  BE  IDLED 

XOP  (?IRDTX,DMAIO  FOR  RADIO  TX 

RETURN  -  RADIO  TX  DMA  I/O  REQUEST  IDLED 

4.4. 3. 7  idle  1822  RX  DMA  I/O 


To  idle  a  previously  initiated  1822  RX  DMA,  the  following 

call  is  used: 

R3  =  PACKET  BUFFER  ADDRESS  OF  1822  RX  DMA  TO  BE  IDLED 

XOP  GISTRXjDMAIO  FOR  1822  RX 

RETURN  -  1822  RX  DMA  I/O  REQUEST  IDLED 
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4. 4. 3. 8  Idle  1822  TX  DMA  I/O 


To  idle  a  previously  initiated  1822  TX  DMA,  the  following 

cal  1  i s  used: 

R3  =  PACKET  BUFFER  ADDRESS  OF  1822  TX  DMA  TO  BE  IDLED 

XOP  @ISTTX,QMAIO  FOR  1822  TX 

RETURN  -  1822  TX  DMA  I/O  REQUEST  IDLED 

4.4. 3.9  1822  I/O  Check  Station  Ready 

The  1822  I/O  Check  Station  Ready  (STIOR)  routine  provides 
the  following  services: 

.  Set  PR  RDY  bit  of  1822  hardware  Control  register 

.  Check  HOST  RDY  bit  of  1822  hardware  Status  register  and 
check  STA  RDY  flag 

The  XOP  vector  name  and  e\ ent  code  for  1822  I/O  Check 
Station  Ready  are  as  follows: 

STIO  EQU  S 

STIOR  DATA  >  0080 

To  initiate  an  1822  I/O  Check  Station  Ready,  the 
following  call  is  issued  by  the  user: 

XOP  OSTIOR.STIO 

RETURN  -  STATION  NOT  READY 

RETURN  +  4  -  STATION  READY 

Once  an  1822  I/O  Check  ’s  issued,  the  STA  RDY  flag  is  checked. 
If  it  is  not  ready,  a  process  is  initiated  which  will  set  the  PR  RDY  bit  (13) 
of  the  1822  TX  Control  register  after  one  second  and  will  set  the  STA  RDY  flag 
to  ready  after  another  second.  After  the  process  is  initiated,  the  1822  I/O 
Check  routine  is  exited  without  adjusting  the  program  counter  (PC).  If  the 
STA  RDY  flag  is  ready,  then  the  HOST  RDY  bit  (8)  in  the  1822  TX  Status 
register  is  checked. 

If  HOST  RDY  is  set  (Host  is  ready),  then  the  program  counter  is 
adjusted  (PC+4)  and  the  1822  I/O  check  routine  is  exited. 

If  HOST  RDY  is  zero  (Host  not  ready),  then  the  routine  is 
exited  without  adjusting  the  program  counter  (PC). 

4.4.3.10  1 822  I/O  Cl  ear  Stati on  Ready 

The  1822  I/O  Clear  Station  Ready  (STIOCL)  routine  clears 
tne  PR  RDY  bit  of  the  1822  hardware  Control  register. 


I 


I 
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The  XOP  vector  name  and  event  code  for  1822  I/O  Clear 
Station  Ready  are  as  follows: 

STIO  EQU  8 

STIOCL  DATA  >  0081 

To  initiate  an  1822  I/O  Clear  Station  Ready,  the 
following  call  is  issued  by  the  user: 

XOP  ©STIOCL , Si  10 
RETURN 

4.4.3.11  IPR  DMA  Packet  Buffer  Overhead 

The  IPR  DMA  Packet  Buffer  Overhead  format  is  illustrated 

in  Figure  20: 


a 


e 


o 


RESERVED 

One  word  nas  been  reserved  for  future  expansion  o'-  the 
IPR  Packet  Buffer  Overhead. 

DMA  I/O  FORWARD  POINTER 

Pointer  to  next  DMA  I/O  event  packet  buffer  in  the  DMA 
1  inked-1 ist  (queue) . 

DMA  I/O  CALLING  PROCESS  I/D 

Job  I/'D  and  Event  Code  of  current  DMA  I/O  event.  (Read 

by  User). 


DMA  WORD  COUNT  REGISTER 

Image  of  DMA  Word  Count  hardware  register  when  DMA 
interrupt  or  idle  occurs.  (Read  by  User) 

DMA  ADDRESS  REGISTER 

Image  of  DMA  Address  hardware  register  when  DMA  in „errupt 
or  idle  occurs.  (Read  by  User) 

DMA  STATUS  REGISTER 

Image  of  DMA  Status  hardware  register  when  DMA  interrupt 
or  idle  occurs.  (Read  by  User) 


» 
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-46 

-44 

-42 

-40 

-38 

-j6 

-34 

-32 

-30 

-28 

-26 

-12/  -24 
-10 
-  8 

-  2  /  -  6 
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DMA  I/O  FORWARD  POINTER 
DMA  I/O  CALLING  PROCESS  I/D 
DMA  WORD  COUNT  REGISTER 
DMA  ADDRESS  REGISTER 
DMA  STATUS  REGISTER 
DMA  CONTROL  PARAMETERS 
RADIO  TX  RANDOMIZATION  TIME  j 
DMA  I/O  RETRY  ON  ERROR  | 
DMA  I/O  EVENT  CLOCK  (00-15)  I 
DMA  I/O  EVENT  CLOCK  (16-31  )  | 

DMA  I/O  STATUS  | 

USER  SPACE  1/7  I 

PACKET  BUFFER  ASSIGN/RELEASE  I 
PACKET  BUFFER  CHAIN  ADDRESS  | 
PACKET  PREAMBLE  1/3  | 

PACKET  HEADER  /  TEXT  | 


FIGURE  20 
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DMA  CONTROL  PARAMETER 

Contains  DMA  Control  word  created  user  and/or  DMA  I/O 
initiate  routine,  which  will  be  loaded  into  the  DMA  Control /Status 
hardware  register.  Used  to  initiate  and  stop/clear  radio  and  1822  DMA 
hardware.  (Provided  by  User) 

RADIO  TX  RANDOMIZATION  TIME 

Contains  randomization  time  for  Radio  TX  DMA  I/O  initiate 
events.  This  value  of  time  is  loaded  into  the  Radio  TX  Randomize 
hardware  register  before  the  Radio  TX  DMA  hardware  is  enabled  for 
transmission.  (Provided  by  User). 

DMA  I/O  RETRY  ON  ERROR 

Contains  retry  limit  set  by  user  and  error  count  by  DMA 
channel .  (Retry  Limit  is  Provided  by  User  --  Maximum  of  255). 

DMA  I/O  EVENT  CLOCK 

Loaded  with  contents  of  the  32-bit  Elapsed  Timer  each 
time  i/O  Status  is  updated.  (Timer  is  binary  count  incremented  at  6.51 
microsecond  rate). 

DMA  I/O  STATUS 

Indicates  current  processing  status  of  the  packet  buffer. 
Figure  21  defines  the  iPR  I/O  Status.  (Read  by  User). 

USER  SPACE 

Seven  words  reserved  to  be  defined  and  used  by  the  high 
level  programs  which  used  the  packet  buffers  for  packet  I/O  processing. 
(For  User's  Own  Needs). 

PACKET  BUFFER  ASSIGN/ RE LEASE 


Indicates  if  packet  buffer  is  presently  assigned  tc  a  job 
or  resides  on  the  packet  buffer  queue.  (Read  by  User). 

PACKET  BUFFER  CHAIN  ADDRESS 

Points  to  next  packet  buffer  address  in  the  packet  buffer 

queue. 

PACKET  PREAMBLE 


Contains  the  3  words  of  preamble  used  by  tne  packet  radio 

network. 
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1  1  1  1  1  INITIATED 
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1  1  ENABLED 

j  j 
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1 

1 

1  1  1  INTERRUPTED 

1 

1 

1 

1  1  SERVICE  COMPLETED 

j 

1 

1 

1 

1  SERV  COMP'D  WITH  ERROR(S) 

| 

1 

1 

1 

RADIO  RX  HOLD  /  1822  ERROR 

IDLED 


« 


FIGURE  21  IPR  DMA  I/O  STATUS 
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PACKET  HEADER/TEXT 

Contains  packet  body.  First  word  of  the  header  contains 
the  packet  length  (bits  8  through  15,  least  significant  byte)  in  words. 
Packet  address  passed  in  Radio/1822  DMA  I/O  call  (defines  first  word  of 
packet  header  text).  (Defined  by  User). 

4.4.4  Buffer  Allocation 

This  call  is  used  by  the  system  jobs  to  obtain  dynamic  buffer 
space  for  job  use  and  to  release  the  buffer  space  for  reassignment  when 
it  is  no  longer  needed  by  the  job.  The  allocated  buffer  space  is  in 
zone  3  memory. 


At  present,  two  calls  are  implemented.  These  are: 

Assign  packet  buffer  (ASGPB) 

Release  packet  buffer  (RLSPB) 

The  XOP  call  arguments  are  shown  below: 


BUFFER  EQU  3 

ASGPB  DATA  >  0030 

RLSPB  DATA  >  0031 


4. 4. 4.1  Assign  Packet  Buffer 

This  call  is  used  to  request  a  packet  buffer.  Two 
immediate  returns  are  provided:  the  first  to  indicate  no  buffers  are 
available  for  assignment,  the  second  to  indicate  assignment  of  a  buffer. 
The  buffer  address  is  returned  to  the  caller's  workspace  register  R3  and 
defines  the  first  word  of  the  packet  header/ text.  The  call  is  shown 
below: 


XOP  0ASGPB, BUFFER 

RETURN  -  NO  BUFFER  AVAILABLE 

RETURN+4  -  ASSIGNED  BUFFER  ADDRESS  IN  R3 

4.4.4. 2  Release  Packet  Buffer 

This  call  is  used  to  release  a  previously  assigned  packet 
buffer.  The  address  of  the  packet  buffer  to  be  release  is  contained  in 
the  calling  Job's  workspace  register  R3.  The  operating  system  will  halt 
the  calling  Job  if  the  packet  buffer  address  is  erroneous,  if  the  DMA 
I/O  activity  for  which  the  packet  is  being  used  has  not  completed  or 
been  idled,  or  if  the  packet  buffer  has  already  been  released.  The  call  is 
shown  below: 


R3  »  PACKET  BUFFER  ADDRESS 

XOP  0RLSP3, BUFFER 

RETURN  -  PACKET  BUFFER  RELEASED 
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4.4.5  Interjob  Communication 

This  call  provides  the  mechanism  for  Interjob  communication. 

It  Is  used  for  Initial  job  calls  and  job  call  returns  In  response  to  an 
Initial  job  call . 

An  Interjob  call  Is  defined  by  a  job  call  ID  and  a  data  word. 
The  job  call  ID  consists  of  a  job  ID  (most  significant  byte)  and  an 
event  code  (least  significant  byte)  defined  by  the  called  job.  T tie  job 
call  ID  Is  defined  by  the  XOP  Instruction.  The  optional  data  word, 
typically  a  buffer  address,  Is  defined  In  the  calling  job's  workspace 
register  RJ.  Note  that  only  zone  3  buffer  Is  accessible  by  all  jobs. 
Local  zone  t  buffer  of  a  job  is  not  directly  accessible  by  other  jobs 
due  to  bias  register  2  modification  by  the  operating  system.  The 
interjob  call  is  Illustrated  below.  JBCALl  (01)  Is  the  XUP  vector  name. 

R3  «  OPTIONAL  DATA  WORD 

XOP  <$( job  call  ID), JBCALL 

return  -  called  job  not  resident 

RETURN+4  -  JOB  CALL  ISSUED 

The  operating  system  replaces  the  called  job's  ID  with  the 
calling  joo's  ID  and  Inverts  the  most  significant  bit  of  the  event  code 
in  the  job  call  ID.  This,  with  the  data  word.  Is  placed  In  the  called 
job's  workspace  register  R2  and  R3  when  It  Is  initiated  from  the  point 
of  suspension.  The  content  of  R2  Is  the  job  call  ID  to  be  used  for 
recall.  If  necessary,  of  the  original  job  when  the  event  processing  Is 
completed.  The  job  call  return  will  return  the  original  job  call  ID  and 
data  word  to  the  Initial  calling  job. 

The  called  job  decodes  the  event  code.  The  most  significant 
bit  of  the  event  code,  If  one,  Is  a  request  to  perform  event  processing 
by  the  job.  If  zero,  It  defines  a  completed  event  previously  requested 
by  the  job. 


4.4.6  Util  1 ty  Service 

Four  utility  functions  are  provided  via  XOP  call  as  shown 

bel  ow: 

.  Update  enabled  CPU's  execution  vector  (CPUV) 

.  Get  CPU's  configuration  table  address  (CCADDR) 

.  Move  error  data  to  buffer  (MOVER) 

.  General  Purpose  AMDM  (GPAMDM) 

The  XOP  vector  name  and  event  codes  are  listed  below: 
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UTIL  EQU  7 

CPfJV  DATA  >  0070 

CCADDR  DATA  >  0071 

MOVER  DATA  >  0072 

GPAMOM  DATA  >  0073 

These  functions  are  used  by  the  operating  system  and  off-line 
diagnostic  jobs. 

4*4. 6.1  Update  Enabled  CPU  Execution  Vector 

This  call  is  utilized  to  enable  and  disable  operation  of 
implemented  CPUs.  A  CPU  wnen  disabled  will  idle  at  interrupt  level  3. 

It  is  used  by  diagnostic  jobs  to  restrict  execution  (testing)  to  a 
single  CPU.  The  desired  vector  is  passed  in  the  least  significant  byte 
of  workspace  register  R3.  Two  immediate  returns  are  provided:  the  first 
o  indicate  that  the  System  Job  List  entry  was  not  updated  because  all 
the  CPUs  represented  in  the  argument  were  not  implemented;  the  second  to 
idicate  that  the  entry  was  updated.  The  call  i  v  shown  below: 

R3  =  DESIRED  CPU  EXECUTION  VECTOR 
XOP  0CPUV.UTIL 

RETURN  -  SYSTEM  JOB  LIST  ENTRY  NOT  UPDATED 
RETURN+4  -  SYSTEM  JOB  LIST  ENTRY  UPDATED 

R3  bit  15  oefines  CPU  1.  R3  bit  14  defines  CPU  2.  Each 
oit  if  1  enables,  or  if  0  disables,  execution  by  the  corresponding  CPU . 

4. 4. 6. 2  Get  CPU  Configuration  Table  Address 

This  Provides  the  absolute  zone  4  address  of  tie 
executing  CPU  s  Configuration  Table  address  thereby  providing  accest  to 
the  data  contained  tnerein.  The  call  is  shown  below: 

XOP  @CCADDR,UTIL 

RETURN  -  ADDRESS  IN  REGISTER  R3 

4. 4. 6. 3  Move  Error  Data  to  Buffer 

This  call  defines  summary  error  data  generated  by  a  job 
or  the  operating  system.  The  process  moves  the  error  data  to  an 
operating  system  defined  buffer.  Tin's  data  is  subsequently  inserted  in 
Load  Request  ROP  packets  to  report  PR  failure  to  a  remote  facility. 

The  number  of  error  data  words  (equal  to  or  less  than 
LQ'  is  defined  in  register  R2.  The  start  address  of  the  data  is 
defined  in  R3.  Data  in  ascending  addresses  is  moved  to  the  buffer.  Tne 
call  is  illustrated  below: 
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R2  =  NUMBER  OF  16-BIT  WORDS 
R3  =  START  ADDRESS  OF  WORDS 
XOP  ©MOVER, UTIL 

RETURN  -  DATA  MOVED  TO  ERROR  BUFFER 
4. 4.6.4  General  Purpose  AMDM 


This  call  wll  change  a  memory  location  or  transfer  the 
contents  of  a  memory  location  to  the  user's  buffer.  Operation  of  the  call  is 
defined  by  the  contents  of  R4,  which  will  contain  0  for  alter  memory  (AM) 
or  2  for  display  memory  (DM). 


The  address  of  the  buffer  to  be  used  is  defined  in  R2.  The  HI 
and  LO  address  of  the  AMDM  location  is  defined  in  R5  and  R6.  The  AMDM  address 
can  be  of  tnree  tyres;  CPU,  BUS,  or  Relocatable  job.  The  type  of  address  is 
defined  by  trie  contents  of  R5  as  illustrated  below: 


ADDR  TYPE 

CPU 

BUS 

Reloc.  Job 


R5  CONTENTS 

HI  BYTE 

0 

0 

Job  ID 


LO  BYTE 
80  HEX 

HI  4  bits  of  ADDR 
80  HEX 


The  remainder  of  the  address  is  defined  by  the  contents  of  Rb  for 
cither  of  the  three  cases.  The  call  is  illustrated  below: 


R2  =  ADDRESS  OF  BUFFER  LOCATIGN 
R4  =  OPERATION  FLAG  -  0  ALTER  MEMORY 

2  DISPLAY  MEMORY 
R5  =  HI  ADDR  OF  AMDM  LOCATION 
Rb  =  LO  ADDR  OF  AMDM  LOCATION 
XOP  OGP AMDM, UTIL 
RETURN  -  OPERATION  COMPLETED 

BUFFER  ADDRESS  INCREMENTED 
AMDM  LOCATION  ADDRESS  INCREMENTED 


4.4.7  I/O  TAG  REAU/WRITE  SERVICE 

Seven  I/O  TAG  functions  are  provided  via  XOP  call  as  shown  below: 

Read  MS  word  of  elapsed  timer  (ROMS) 

Read  LS  word  of  elapsed  timer  (RDLS) 

Read  Doth  words  of  elapsed  timer  (RDBO) 

Reset  elapsed  timer  (RESETT) 

Read  PR  ID  straps  (RDID) 

Read  RAM  image  of  MODE  straps  ( RDMODE ) 

Write  to  front  panel  CODE  and  DATA  LEDS  (WRPNL  j 
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The  XOP  vector  name  and  event  codes  are  listed  below: 


IOTAG 

EQU 

10 

ROMS 

DATA 

>  XXAO 

RDLS 

DATA 

>  XXA1 

RDBO 

DATA 

>  XXA2 

KESETT 

DATA 

>  XXA3 

RDID 

DATA 

>  XXA4 

RDMODE 

DATA 

>  XXA5 

WRPNL 

DATA 

>  XXA6 

Where  XX  equals  the  word  offset  from  the  beginning  of  the  caller's 

workspace. 


4. 4. 7.1  Read  MS  Word,  of  Elapsed  Timer 

This  call  will  return  the  MS  word  of  the  elapsed  timer  in  the 
user  s  workspace  register  indicated  by  the  MS  byte  of  the  event  code.  The 
call  is  shown  be! ow: 

XX  =  USER'S  WORKSPACE  REGISTER 

EC  DATA  >  XXAO 

XOP  @EC, IOTAG 

RETURN  -  ELAPSED  TIME  IN  WORKSPACE  REGISTER  XX 

4. 4. 7. 2  Read  LS  Word  of  Elapsed  Timer 

XX  =  USER'S  WORKSPACE  REGISTER 

EC  DATA  >  XXA1 

XOP  L^EC,  IOTAG 

RETURN  -  ELAPSED  TIME  IN  WORKSPACE  REGISTER  XX 

4.4. 7. 3  Read  Both  Words  of  Elapsed  Timer 

This  call  will  return  the  MS  word  of  the  elapsed  timer  in  the 
user's  workspace  register  indicated  by  the  MS  byte  of  the  event  code.  The  LS 
word  of  the  elapsed  timer  will  be  returned  in  the  nexL  higher  workspace 
register.  The  MS  word  returned  is  checked  to  be  sure  it  is  consistent  with  a 
LS  word  that  may  have  just  rolled  over.  The  call  is  shown  below: 

XX  =  USER'S  WORKSPACE  REGISTER 

EC  DATA  >  XXA2 

XOP  0EC, IOTAG 

RETURN  -  MS  WORD  OF  ELAPSED  TIME  IN  WORKSPACF  REGISTER  XX 
-  LS  WORD  OF  ELAPSED  TIME  IN  WORKSPACE  REGISTER  XX+1 


-79- 


1  PR  0. S.  Users  Guide 


June  3U,  1  983 


4 . 4 . 7 . 4  Reset  El  apsed  Timer 

This  call  will  reset  the  elapsed  timer  to  zero.  The  call  is 

shown  below: 


XX  =  DON’T  CARE 
EC  DATA  >  XXA3 
XOP  0EC, IOTAG 

RETURN  -  ELAPSED  TIMER  RESET 

4. 4. 7.5  Read  PR  ID  Straps 

This  call  will  return  the  contents  of  the  PR  ID  straps  in  the 
user's  workspace  register  indicated  by  the  MS  byte  of  the  event  code.  The 
call  is  shown  below: 

XX  =  USER'S  WORKSPACE  REGISTER 
EC  DATA  >  XXA4 
XOP  OEC , IOTAG 

RETURN  -  PR  ID  CODE  IN  WORKSPACE  REGISTER  XX 

4.4. 7.6  Read  RAM  Image  of  MODE  Straps 

This  call  will  return  the  contents  of  the  RAM  image  of  the  MODE 
straps  in  che  user's  workspace  register  indicated  by  the  MS  byte  of  the  event 
cooe.  The  call  is  shown  below: 

XX  =  USER'S  WORKSPACE  REGISTER 
EC  DATA  >  XXA5 
XOP  @EC, IOTAG 

RETURN  -  MODE  CODE  IN  WORKSPACE  REGISTER  XX 

4. 4. 7. 7  Write  to  Front  Panel  CODE  and  DATA  LEDS 


This  call  will  write  the  contents  of  two  consecutive  user 
workspace  registers  to  the  CODE  and  DATA  LEDS  respectively  of  the  front 
panel .  The  user's  workspace  registers  are  indicated  by  the  MS  byte  of  the 
event  code.  The  call  is  snown  below: 

XX  =  USER'S  WORKSPACE  REGISTER 
EC  DATA  >  XXA6 
XOP  0EC, IOTAG 

RETURN  -  CONTENTS  OF  WORKSPACE  REGISTER  XX  WRITTEN  TO  CODE  LEDS 
-  CONTENTS  OF  WORKSPACE  REGISTER  XX+1  WRITTEN  TO  DATA 
LEDS 
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4.4.8  Down  Load  Service 

Two  functions  are  provided  to  facilitate  down  loading  of  the  OS  code 
or  protocol  jobs.  They  are  provided  by  XOP  call  as  shown  below: 

.  Fetch  a  word  of  OS  or  Protocol  data  (DLLGET) 

.  Insert  name  of  OS  into  Packet  Buffer  (DLLOSI) 

The  XOP  vector  name  and  event  codes  are  listed  below: 

DLLSUB  EQU  9 

DLLGET  DATA  >  90 

DLLOSI  DATA  >  91 

4. 4. 8.1  Fetch  a  Word  of  OS  or  Protocol  Data 

This  call  will  fetch  a  word  of  OS  or  Protocol  data  based  upon  the 
protocol /OS  flag  and  a  sequence  #.  The  call  is  shown  below: 

R5  •  WORD  # 

R6  =  PROTOCOL/OS  FLAG 
XOP  0OLLGET, DLLSUB 
Return  -  R5  &  R6  UNCHANGED 

-  R7  =  FETCHED  WORD 

-  R3  =  TAGFLAG  (DATA/ADDR) 

-  R9  =  BEGJOB  (START  OF  JOB  FLAG) 

-  RO  =  ENDJOB  (END  OF  JOB) 

-  R1  =  ENDLOD  (END  OF  LOAD) 

4.4.8. 2  Insert  Name  of  OS  into  Packet  Buffer 

This  call  will  insert  the  name  of  the  loaded  part  of  the  OS  into  the 
users  packet  buffer.  The  call  is  shown  below: 

R4  =  PACKET  BUFFER  INPUT  POINTER 

XOP  0DLLOSI, DLLSUB 

RETURN  -  OS  NAME  IN  PACKET  BUFFER 

4.4.9  Operator  Control /Monitor  (Debug)  Job  Call 

A  job  may  issue  a  call  to  the  operating  system  debuy  job.  The 
call  defines  an  operator  command  or  set  of  chained  commands  as  defined 
in  Section  5.4.  The  call  is  shown  below: 

R3  =  ADDRESS  OF  ASCII  CHARACTER  STRING 
XOP  0job  call  I0.JBCALL 

RETURN  -  DEBUG  NOT  RESIDENT  (System  Failure) 

RETURN +4  -  JOB  CALL  ISSUED 
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JBCALL  the  vector  name  equals  1.  The  job  call  ID  word  equals 
0500j g.  The  job's  workspace  register  R3  defines  the  start  address  of 
the  command  ASCII  character  string.  The  ASCII  character  string  Is 
stored  In  the  oraer  left  oyte/rlght  byte  In  Increasing  memory  addresses 
terminated  by  ETX  In  the  zone  3  address  space. 


’CP' 


AL 
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5  OPERATING  PROCEDURES 

The  following  paragraphs  describe  operator  actions  and  displays 
v'-iible  to  the  operator  during  operation  of  the  PR. 

5 . 1  Operation/Hardware  Strap  Options 

The  hardware  straps  which  effect  PR  operation  are  described  in 
Section  2.11.  The  terminal  type  and  terminal  baud  rate  straps  must  be 
set  for  the  console  connected  to  the  PR  I/O  channel.  The  PR  ID  straps 
are  set  to  uniquely  define  the  PR.  The  auto-restart  and  down-line  load 
straps  are  set  to  define  the  appropriate  operational  configuration  as 
described  below.  The  radio  RF  frequency  straps  are  set  to  define  the 
value  used  for  down-line  loading  of  the  PR.  User  jobs  nay  use  this 
value  or  other  values.  The  initialization  mode  straps  are  normally 
zero  except  when  initialization  faults  need  to  be  debugged. 

for  changed  values  of  the  auto-restart,  down-line  load,  and/or 
radio  RF  frequency  switches  to  take  effect,  power-up  initialization  or  a 
restart  must  be  (re)executed,  i.e.,  the  INIT  or  RESET  pushbutton  must  be 
pushed  or  the  IN  or  RS  console  command  must  be  executed. 

5.1.1  Normal  Unattended  Operation 

For  normal  PR  operation,  unattended  by  an  operator,  auto¬ 
restart  and  down-line  load  are  enabled  via  the  hardware  straps.  The 
PR  I/O  channel  console  need  not  be  implemented  except  for  use  as  a 
monitor  display.  After  initial  initialization  invoked  by  the  operator, 
down-1  i ne  l  oadi ng  of  the  remaining  portion  of  the  operating  system  and 
the  user  jobs  and  initiation  of  job  execution  is  done  automatically. 

The  PR  will  auto-restart  and  if  necessary  reload  software  in  the  event 
of  failure. 


Operational  sequence 

Operator  action  Depress  and  release  front  panel  initiate  (INIT) 

pushbutton. 


Display 


Console  bell,  then  LED  display  of  sequential 
execution  of  initialization  sections  1-6  (01-06  in 
code  LEDs)  Dy  each  CPU  (N000  in  data  LEDs,  where  N  is 
the  CPU  number).  Blinking  display  if  errors.  See 
Section  5.2. 
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LED  display  of  initialization  section  7  by  one  CPU 
plus  console  message  for  down-line  load  of  operating 
system : 

down-line  load-end 

Blinking  LEDs  and  console  messages  if  error  *>ee 
Section  5.2  and  Section  5.4,17. 

LED  display  of  initialization  section  8  by  each 
CPU  (08  in  code  LEDs,  NOQO  in  data  LEDs).  Blinking 
display  if  errors.  See  Section  5.2. 

LED  display  (09  N000)  and  console  messages  for 
initialization  and  job  loading: 

DOWN-LINE  LOAD-END 

Blinking  LEDs  and  console  messages  if  error.  See 
Section  5.2  and  Section  5.4.17. 

Final  LED  display  for  successful  initialization  is 
OF  0000.  Console  message  for  Debug  job  initiation: 

JOB  DEBUG 

•(  Display:  Console  message  for  initiation  of  job  execution: 

AUTO-XJ 

LED  display  is  blanked  (turned  off). 

%  5.1.2  Normal  Attended  Operation 

For  normal  PR  operation,  attended  by  an  operator,  auto-restart 
is  enaol ed  and  down-line  load  is  disabled  via  hardware  straps.  The 
remaining  portion  of  the  operating  system  and  the  user  jobs  are  loaded 
by  tne  operator  via  the  PR  I/O  channel  console.  Job  execution  is 
<  initiated  via  the  operator  XJ  console  command.  Tne  PR  will  auto- restart 

in  the  event  of  failure.  Additional  operator  action  is  required  only  if 
reloading  of  software  is  necessary. 

Operational  Sequences 

'<  Operator  Action  Depress  and  release  front  panel  initiate  ( IN  IT) 

pushbutton. 


i  « 


( 


( 


Di  spl  ay 


i 


Di  spl  ay 


Di spl ay 


Di  spl  ay 
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Di spl a y 


Di  spl  ay 

I  - 


i 


Di  spl  ay 


Di spl ay 


Console  bell  ,  then  LED  display  of  sequential 
execution  of  initialization  sections  1-6  (01-06  in 
code  LEDs)  by  each  CPU  (N000  in  data  LEDs,  where  N  is 
the  CPU  number).  Blinking  display  if  errors.  See 
Section  5. 2. 

LED  display  of  initialization  section  7  by  one  CPU 
plus  console  message  for  loading  of  operating  system: 

TURN  TAPE  ON-TURN  TAPE  OFF-END 

Blinking  LCDs  and  console  messages  if  error.  See 
Section  5.2  and  Section  5.4.17  for  tape 
cassette  load  procedure. 


LED  display  of  initial  ization  section  8  by  each 
CPU  i08  N000  in  code/data  LEDs).  Blinking  display  if 
errors.  See  Section  5.2. 

Final  lED  display  for  successful  initialization  - 
OF  0000.  Console  message  for  Debug  job  initiation: 

JOB  DEBUG 


* 


Debug  job  is  executing  in  PR  halted  (stand-alone) 
mode.  Operator  is  required  to  load  jobs  and  initiate 
job  execution.  See  Section  5.4  for  console 
commands. 

b.1.3  Maintenance/Test  Operations 


For  diagnostic  testing  and  maintenance  of  the  IPR,  auto¬ 
restart  and  down-line  load  are  normally  disaoled  via  the  hardware 
straps.  A  local  I/O  channel  console  with  software  load  capability  is 
implemented.  Al  ternati  vely  a  simpler  local  console  (keyboard/printer) 
may  be  used  if  down-line  load  (strap)  is  enabled  to  remotely  load  tne 
operating  system  and  off-line  diagnostic  software. 

For  special  maintenance  situations,  the  initialization  mode 
straps  may  be  set  (See  Section  5. 2. 3.1),  the  1 oad-and-go 
capability  (see  Section  5.2.3. 2)  may  be  used,  or  the  operator  GO 
(see  Section  5.4.15)  command  may  be  used. 

Tne  operational  sequence  is  the  same  as  shown  in  Section 
0.1.2.  The  operating  system  is  down-line  loaded  or  loaded  locally  by 
the  operator  depending  upon  the  down-line  load  strap.  The  final  LED 
display  is  UF  0U00  or  blinking  OF  nnnn  to  define  the  number  (nnnnj  of 
initialization  errors.  Also  if  errors,  the  console  message  below  is 
printed: 


INIT/RSET  FAULT 
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6.1.4  Operator  Action  Following  a  Fault 

If  tue  PR  is  configured  for  auto-restart,  initialization  is 
automatically  invoked  as  part  of  the  fault  service.  If  not,  the 
operator  must  manually  restart  the  system  following  a  fault.  This  may 
be  done  either  by  executing  the  restart  (RS)  command  or  by  depressing 
tne  RSET  pushbutton.  The  execute  jobs  (XJ)  command  should  not  be 
executed  following  any  fault  except  “TRACE  FAULT".  Other  operator 
control /moni tor  console  commands  may  be  entered  before  restarting  the 
system. 


5 . 1 . 4 . 1  LED  Faul  t  Pi  spl  ay 


During  steady-state  operation,  hardware  faults  are 
displayed  in  the  front  panel  LEDs  in  the  following  format: 


Code  digit  1  : 
Code  digi t  2: 
Data  digits  1  -4: 

Type  bit  0  on: 
Type  bit  1  on: 
Type  bit  2  on: 
Type  bit  3  on: 
Type  =  0: 


CPU  number 
Type 

PC,  for  type  >  0 
ST,  for  type  =  0 
Watch  dog  timer 
Bus  response  time-out 
lnval  id  op-code 
Memory  parity  error 
Unused  interrupt 


For  the  hardware  faults  which  cause  a  failure  interrupt, 
the  program  counter  (PC)  when  the  fault  interrupt  occurred  is  displayed. 
A  failure  interrupt  is  not  presented  to  the  CPU  until  the  instruction 
after  the  one  which  caused  the  failure,  and  by  the  time  it  is  recognized 
by  the  CPU,  the  program  counter  (PC)  will  have  been  incremented  once 
again,  i.e.,  the  PC  displayed  points  to  the  instruction  which  is  two 
instructions  beyond  the  instruction  which  actually  caused  tne  hardware 
fail  ure. 


For  unused  interrupts,  the  status  (ST)  after  trie  trap  has 
taken  is  displayed.  The  CPU  sets  the  interrupt  mask  -  the  least  four 
significant  bits  of  the  ST  -  to  a  value  one  less  than  the  interrupt 
level.  For  example,  a  ST  =  0001  would  indicate  that  a  level  2  interrupt 
nad  occurred.  Levels  2,  5,  10,  13,  14,  and  15  are  unused. 

Because  of  the  often  repetitive  nature  of  hardware 
fiults,  the  fault  service  includes  a  safeguard  that  only  one  fault  per 
CPU  can  occur  without  restarting  the  system.  If  a  second  one  does 
occur,  the  CPU  takes  one  of  three  actions,  depending  on  the  strap 
settings:  if  auto-restart  and  down-line  load  are  enabled,  power-up 
initialization  is  invoked,  if  auto- restart  is  enabled  but  down-line  load 
is  not  enabled,  restart  initialization  is  invoked;  if  neither  auto¬ 
restart  nor  down-line  load  is  enabled,  the  CPU  idles. 
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b .  1  .4.2  Consol  e  di  spl  ay 

All  faults,  hardware  and  software,  are  printed  on  the 
tr  console  in  the  format  of  the  message  display  for  the  display  job  (DJ) 

i  command  shown  in  Section  5.4.8. 

b.2  Ini  ti al  i zation 

5.2.1  Causes 

9j  When  power  is  first  applied  to  the  PR,  power-up  initialization 

occurs.  If  power  is  lost  and  then  re-applied  before  initialization  has 
completed,  the  section  currently  being  executed  is  begun  again.  After 
initialization  has  been  completed,  a  loss  and  re-application  of  power 
causes  restart  initialization  to  begin  again. 

®  Pushing  the  INI T  pushbutton  at  any  time  causes  power-up 

initialization.  Pushing  the  RSET  pusnbutton  causes  the  initialization 
section  being  executed  to  be  begun  again.  After  initialization  has  been 
completed,  pushing  the  RSET  pushbutton  causes  restart  initialization  to 
begin  again. 

After  initialization  has  completed,  the  operator  may  enter 
console  commands.  The  IN  command  is  functionally  equivalent  to  the  INIT 
pushbutton;  executing  it  causes  power-up  initialization.  Tne  RS  command 
is  functionally  equivalent  to  the  RSET  pushbutton;  executing  it  causes 
restart  initialization. 

I 

In  order  to  re-initial  ize  the  system  after  initialization  has 
completed,  push  RSET  or  execute  the  RS  command  if  you  don't  need  any  of 
the  sections  of  power-up  (RAM  tests,  mapping  register  tests,  or 
bootstrap  load)  to  be  done.  Otherwise  push  INIT  or  execute  the  IN 
command.  Do  not  select  INIT  or  IN  if  the  contents  of  any  of  the  RAM, 

8  e.g.,  loaded  jobs,  need  to  be  preserved. 

5.2.2  Pi  spl  ays 

5. 2.2.1  LED  display 

>  The  format  of  the  front  panel  LED  display  during 

initialization  is  as  follows: 

Code  Di git  1  :  0 

Code  Digit  2:  Section  ID 

i 

Data  Digit  1  :  CPU  number* 

Data  Uiyits  2-4:  Error  code  (if  blinking) 
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23. 


As  each  CPU  starts  execution  of  each  section,  the  section 
and  cPU  number  are  ai splayed.  The  section  IDs  are  listed  in  Figure 


When  an  error  is  detected  during  initialization,  its  code 
is  superimposed  on  the  LED  display  as  the  last  3  digits  of  the  data 
LEDs,  and  the  display  is  blinked  for  at  least  2  seconds.  The  error 
codes  are  listed  in  Figure  23. 

An  "F"  is  displ'v/ed  in  the  second  digit  of  the  code  LEDs 
and  the  total  numoer  of  initialization  errors  is  displayed  in  all  4 
digits  of  the  data  LEDs  in  tne  last  section.  If  the  number  of  errors  is 
non-zero,  the  display  is  blinked. 

5. 2. 2. 2  Consol e  messages 

The  beginning  of  power-up  initialization  is  announced  by 
trie  consol  e  bel  1  . 

Section  7  includes  the  bootstrap  load  of  the  operating 
system.  The  console  messages  and  operator  actions  are  described  in 

Section  5.4.16  or  Section  5.4.17.  Section  9  may  include  a  , 

job  down-line  load  with  the  accompanying  console  message: 

DOWN-LINE  LOAD-END 

After  initialization  has  completed,  if  there  were  any 
errors,  tne  following  console  message  is  printed:  I 

INIT/RSET  FAULT 

In  any  case,  the  message  announcing  the  beginning  of  the 
execution  of  Debug  is  then  printed: 

JOB  DEBUG  ' 

5. 2.2.3  Error  Information  Stored  in  Memory 

Information  about  initialization  errors  is  stored  in 
memory.^  The  total  number  of  errors  is  stored  at  the  location  labeled  » 

"WSINER" .  The  first  error's  section  ID,  CPU  number,  and  error  code 
(i.e.,  2  words  which  are  the  contents  of  the  front  panel  LEDs),  the 
CPU's  status,  program  counter,  and  workspace  pointer,  and  the  contents 
of  thej  6  workspace  registers  are  stored  at  the  location  labeled 
“ERBFK".  The  number  of  times  the  PR  has  restarted,  without  going  back 
to  power-up  initialization,  is  stored  at  the  location  labeled  "WSINRC".  ! 


\ 
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SECTION 

ID  SECTION  NAME 

W  a  MB  MB  — —  _  MB  mmmm  mb  «■  mm 

I 

Power-Up  1  PROM  checksum  test 

2  RAM  test  with  incrementing  test  values 
|  3  RAM  test  with  decrementing  test  values 

4  Mapping  register  read  back  test 

5  Mapping  register  address  memory  test 

I  6  RAM  test/ initial  ization  with  zero 

7 d  J  Bootstrap  load  and  checksum  generation 

Restart  8  OS  initialization  and  OS  checksum  tests 

9  OS  initialization  and  jobs1  load 

and  checksum  tests 

AL2]  Error  summary 

|  [1  j  Section  ID  7  is  displayed  only  by  the  first  CPU  to  execute  it. 

l2j  When  the  number  of  errors  is  displayed,  the  section  ID  character 
changes  to  an  F. 


FIGURE  22  DEFINITION  OF  INITIALIZATION  SECTION  IDS 
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ERROR  CODE  SECTION  ID  ERROR  DESCRIPTION 


100-108 

7, 

SOI 

4 

902 

4 

903 

4 

904 

4 

905 

4 

906 

4 

aoxlT  J 

1,8 

AYY^J 

9 

BOX^-i 

1,8 

BYYL2J 

9 

COO 

8, 

zzzl3J 

2,3,6 

zzz^3  J 

5 

Load  error  -  see  Section  5.4.15 

(LED  error  ION  corresponds  to  printed  error  N) 

Bias  register  1  did  not  read  back  correctly 

Limit  register  1  did  not  read  back  correctly 

Bias  register  2  did  not  read  back  correctly 

Limit  register  2  did  not  read  back  correctly 

Bias  register  3  did  not  read  back  correctly 

Limit  register  3  did  not  read  back  correctly 

Checksum  for  zone  4  address  space  X  incorrect 

Checksum  for  job  YY  incorrect 

Parity  or  bus  time- out  error  in  zone  4 
address  space  X 

Parity  or  bus  time-out  error  in  job  YY 
Parity  error  in  zone  4  RAM  (CPU  addresses 
A810-BFFE,  bus  addresses  FD408-FDFFF ) 

RAM  test  error  between  bus  addresses 
ZZZOO  and  ZZZFF 

Mapping  register  address  memory  test  error 
at  bus  address  ZZZOO 


[1]  The  zone  4  address  spaces  are: 


X  CPU  Addresses  Bus  Addresses 


1  F000-FFFE 

2  E000-EFFE 

3  AD42-AE5C 

4  B320-BE1 2 


FF800-FFFFF 
FF000-FF7FF 
FD5A1 -FD72E 
FD990-FDF0S 


L2]  Jobs  are  numbered  05-] 5  <  =  YY  <  =  2815 


iJj  The  possible  values  of  ZZZ  depend  on  where  RAM  is  actually 

installed.  Currently,  000  <=111  <=  Q2B,  040  <=111  <=  04F,  or 
FD4  <=111  <=  FDF. 

FIGURE  23  DEFINITION  OF  INITIALIZATION  ERROR  C0DF.3 
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5.2.3  Special  Test  Modes  and  Procedures 
5. 2.3.1  Test  Mode  Straps 

Three  straps  on  tne  Configuration  Board  control  special 
initial  ization  test  mooes  to  aid  in  debugging: 

Bit  13:  Loop  on  error 

Bit  14:  Write  in  loop  on  error 

Bit  15:  Mini-initialization 

The  "loop  on  error"  straps  (bits  13  and  14)  have  effect 
only  when  an  initial  ization  error  has  been  detected.  Once  an  error  has 
been  detected,  the  CPU  will  loop  indefinitely  on  the  set  of  instructions 
which  caused/ detected  the  error.  Errors  are  displayed  only  momentarily, 
rather  than  for  2  seconds,  and  the  display  returns  to  normal  for  the 
loops  in  which  the  error  is  not  detected.  Each  loop  is  fast  enough  to 
allow  oscilloscope  and/or  logic  analyzer  investigation. 

The  "write  in  loop  on  error"  mode  (bit  14)  is  identical 
to  the  "loop  on  error"  (bit  13)  mode  except  for  the  addition  of  the 
appropriate  write  instruction  in  the  loop.  For  example,  ti.  RAM  test 
wou  add  the  write  instruction: 

MOV  R0,*R2 

to  the  loop  containing  the  read  and  test  instructions: 

MOV  *R2,R1 

C  R1,R0 

The  mini-initialization  mode  (bit  15)  is  used  when  the 
only  desire  is  to  complete  initi' I ization  in  order  to  use  Debug  commands 
like  AM,  DM,  and  LD.  The  mini -initial ization  mode  skips  sections  1 
through  5.  It  also  displays  errors  only  momentarily  (although  the  total 
numDer  of  errors,  if  any,  is  still  displayed  at  the  very  end). 

The  following  rules  apply  to  the  interaction  of  the 

enabled  straps: 


.  Bit  13  (loop  on  error)  overrides  Bit  0  ( auto-restart) 

.  Bit  14  (write  in  loop  on  error)  overrides  Bits  0  and  13 
.  Bit  15  (mini -initial  ization)  overrides  Bits  0,  13,  and  14 
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5. 2. 3.2  Bootstrap  Load  arid  Gc 

Instead  of  loading  the  O.S.  cassette  tape,  you  can  load 
otner  absolute,  i.e,  not  relocatable,  programs  for  immediate  execution. 
Such  a  load  and  go  program  is  identified  by  adding  the  entry  point 
address  as  the  operand  of  the  END  statement.  This  produces  a  "1 11  tag 
followed  by  the  address  in  the  object  code.  The  loader,  having  read 
this  1"  tag  and  the  address,  branches  to  the  address  after  finishing 
the  1  oad. 


You  should  be  aware  of  the  environment  in  wnich  a  load 
and  go  program  will  execute.  The  CPU  that  does  the  load  (CPU  A)  is  the 
one  that  will  execute  the  program.  The  workspace  in  which  execution 
will  begin  is  "r$TRMS",  currently  at  address  AACC15.  If  you  desire  a 
different  workspace,  do  a  LWPI  instruction.  Interrupts  will  be  masked 
off;  doing  a  LIMI  instruction  will  change  that. 

You  snould  also  be  aware  of  the  other  CPU  (CPU  B),  the 
one  that  didn't  do  the  load.  It  will  stay  in  the  ABS  loop  at  "INJ000" 
until  the  CPU  executing  the  load  and  go  program  (CPU  A)  does  a  RSET 
instruction  or  changes  workspace  "WSIN"  register  R7  to  a  negative  value. 
After  CPU  B  is  released  from  the  ABS  loop,  it  will  display  section  1  and 
its  CPU  number  in  the  LEDs  and  then  branch  to  the  contents  of  workspace 
"WSIN"  register  RIO  (B  *R10).  This  means  that  the  load  and  go  program 
should  set  WSIN's  RIO  to  the  entry  address  appropriate  to  CPU  B  before 
setting  WSIN's  R7  negative. 

You  can  write  a  source  load  and  go  program,  assemble  it, 
and  dump  the  object  file  on  cassette,  or  you  can  just  create  the  machine 
code  on  cassette  ai recti y.  The  cassette  should  be  formatted  according 
to  the  instructions  in  the  following  paragraphs. 

Every  record  should  start  with  a  line  feed  and  an 
asterisk  (*),  except  the  first  record,  which  should  start  with  a  less- 
than  sign  (  <  ).  Every  record  should  end  with  an  "F"  and  a  carriage 
return,  except  the  last  record,  wh.ch  doesn't  need  the  "F". 

The  first  record  should  have  a  "<",  followed  by  five 
zeros  and  the  8  character  name  of  the  program,  ended  by  an  "F"  and  a 
carriage  return. 

All  other  records,  except  the  next-to-last  and  last, 
after  the  line  feed  and  should  have  a  "9"  and  a  four-hex-digit 
absolute  address  at  which  to  start  loading  consecutive  data,  followed  by 
up^to  12  groups  of  "B"  and  a  four-hex-digit  datum  to  load,  ended  by  an 
"F"  and  a  carriage  return.  For  example,  the  record 

*9AD40BQ2E0BA880F 

would  cause  the  data  OLEOig  and  ASBOj  5  (LWPI  >  A880)  to 
be  loaded  at  locations  AD40-]  5  and  AD4216,  respectively. 
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The  next-to-i ast  record,  after  the  line  feed  and 
siiou  d  iiave  "1"  and  the  absolute  entry  address  of  the  program,  ended  by 
a  carnage  return. 

The  last  record  should  have  a  line  feed,  colon 
and  carriage  return. 

5.3  Operator  Interface  for  Console  I/O 

The  console  I/O  routines  implement  job  requested  output  to  the 
local  ( RS— 232  interface)  console  and  allow  an  operator  to  address  input 
to  different  jobs.  The  single  console  is  time-shared  between  the 
multiple  jobs  of  the  IPR. 

If  several  jobs  were  allowed  to  interleave  their  outputs  without 
any  delimiting  character  or  phrase,  the  resulting  display  could  be  very 
confusing  to  the  operator.  For  this  reason,  the  console  I/O  routines 
will  insert  the  phrase  "JOB  XYZ"  before  job  XYZ's  output  is  printed.  If 
job  XYZ  makes  several  output  requests  before  another  job  requests  an 
output,  the  phrase  "JOB  XYZ"  is  only  printed  before  the  first  output. 

The  console  I/O  routines  allow  an  operator  to  type  an  arbitrary 
character  string  and  indicate  which  job  is  to  receive  the  input.  To 
designate  an  input  for  a  particular  job,  the  operator  must  type  "0" 
followed  by  the  job  name,  a  space,  and  the  desired  input  string 
terminated  oy  a  control -E  (ETX)  or  a  carriage  return  (CR).  For  example, 
in  order  to  give  the  input  string  "PQR"  to  job  "XYZ",  tne  operator  would 
type 


0XYZ  PQR  (ETX  or  CR) 

The  job  name  may  be  abbreviated  to  any  number  of  characters.  If 
the  abbreviated  name  is  not  unique,  the  console  I/O  routines  will  give 
the  input  to  the  first  job  requesting  input  that  matches  the  abbreviated 
name.  For  example,  suppose  the  list  of  jobs  requesting  input  contained 
the  following  jobs  in  this  order:  XYZ,  ABC,  ACB.  The  job  XYZ  could  then 
be  referenced  in  any  of  these  ways: 

@X  PQR  (ETX  or  CR) 

@XY  PQR  (ETX  or  CR) 

@XYZ  PQR  (ETX  or  CR) 

The  job  ACB  could  be  referenced  in  two  ways: 

6AC  PQR  (ETX  or  CR) 

0ACB  PQR  (ETX  or  CR) 

if  the  name  ACB  were  abbreviated  to  simply  A,  the  input  would  be 
given  to  job  ABC. 
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Tne  specific  job  to  receive  input  need  not  be  explicitly  stated  for 
every  input.  If  the  first  character  the  operator  types  is  not  then 
everything  typed  is  given  to  the  last  job  that  was  explicitly  specified. 
On  initialization  or  when  the  PR  is  halted,  the  job  Debug  is  assumed  to 
hav'e  received  the  last  input. 

While  inputting  characters,  the  operator  has  limited  editing 
capability,  the  rub-out  (DEL)  character  deletes  the  last  character 
input  by  the  operator  and  is  echoed  by  Several  characters  can  be 

deleted  by  repeatedly  hitting  DEL.  To  delete  all  characters  previously 
entered  and  exit  the  input  mode,  the  operator  should  type  ESC,  which  is 
echoed  by  carriaye  ,  and  line  feed. 

if  the  operator  attempts  to  input  a  character  and  is  echoed  by  "S", 
carriage  return,  and  line  feed,  then  all  tnree  input  buffers  are  busy, 
i.e.,  tne  buffers  nave  not  yet  been  released  by  jobs  that  previously 
received  input. 

If  an  operator  attempts  to  input  a  line  of  text  and  11  ?"  is 
printed,  then  either  the  job  name  entered  is  not  in  the  system  job  list 
or  the  job  specified  will  not  accept  input. 

5.4  Operator  Control /Morn' tor  (DEBUG)  Commands 

The  following  paragraphs  describe  the  operator  console  commands 
used  to  control  and  monitor  PR  operation,  to  support  PR  software 
v~  development,  and  to  support  PR  nardware  testing  and  maintenance. 

5.4.1  Operation 

The  Debug  job  may  be  executed  in  normal  PR  operation  or  PR 
halted  (stand-alone)  operation.  In  normal  operation.  Debug  is  executed 
like  any  other  job.  It  may  be  called  by  the  operator  or  by  another  job. 
It  shares  the  I/O  channel  console  with  other  jobs. 

Wnen  the  PR  is  halted.  Debug  is  executed  in  a  single  CPU 
independent  of  the  normal  scheduler.  Console  and  Radio/1822  DMA  I/O  are 
executed  in  a  polling  non-interrupt  driven  mode.  The  console  is 
dedicated  to  the  Debug  job.  No  other  jobs  are  executed. 

The  PR  nal  ted  mode  is  invoked  by  hardware  or  software  failure, 
upon  completion  of  PR  initial ization,  upon  execution  of  a  software  trace 
breakpoint,  or  by  operator  or  another  jobs  HJ,  TJ,  IN,  or  RS  console 
command.  Normal  execution  is  invoked  by  the  operator  XJ  command  or  by 
automatic  XJ  if  auto-restart  is  enabled  and  jobs  are  resident.  If  the 
PR  is  halted  by  the  operator  HJ  command  or  by  an  operator  specified 
breakpoint  then  the  operator  must  input  the  XJ  command  to  resume  normal 
operation. 


All  operator  commands  are  valid  when  the  PR  is  halted.  Some 
commands  are  invalid  in  normal  operation. 
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5.4.2  Operator  Command  Input 

Tne  operator  In  normal  PR  operation  must  direct  Debug  cofrmand 
Input  to  the  OeDug  Job  by  typing 

0DEBUG 

prior  to  the  command.  This  Is  done  once  and  need  not  be 
repeated  until  the  operator  wishes  to  Input  to  another  job.  A  truncated 
job  name  may  be  used  as  long  as  it  Is  unique. 

The  Input  "ODEP'.u"  Is  not  required  when  the  PR  Is  halted 
(stand-alone)  and  will  If  Input  be  Interpreted  as  a  command  error.  All 
console  Input  Is  given  to  Debug  when  the  PR  Is  halted. 

An  operator  begins  with  a  two  character  command  code, 
sometimes  followed  by  one  or  more  operands,  and  terminated  by  the  single 
character  Control-C  (ETX)  or  carriage  return.  Debug  provides  for 
command  chaining.  The  separates  Individual  commands.  ETX  or 
carriage  return  terminates  the  single  or  set  of  chained  commands.  One 
or  more  ASCII  space  characters  are  used  to  separate  comnand  codes  and 
operands  in  command  strings.  Input  may  be  edited,  as  described  In 
Section  5.3,  until  Input  of  ETX  or  carriage  return.  Operator  Input  for 
a  single  command  or  set  of  chained  commands  Is  limited  to  a  single 
console  line. 

Debug  Interprets  and  executes  the  command.  Upon  completion  of 
command  processing  a  carriage  return,  line  feed,  line  feed  is  output. 

If  a  command  Input  syntax  error  Is  detected,  the  message  "CMD?"  Is 
printed. 


All  numeric  operator  Input  and  numeric  display  Is  In 
nexaaeclmal  0-9,  A-F. 

5.4.3  Restart  Initialization  (RS)  Command 

This  command  Is  equivalent  In  operation  to  depression  of  the 
front  panel  restart  (RSET)  pushbutton.  A  RSET  instruction  Is  executed 
to  Invoke  restart  Initialization.  Command  chaining  after  RS  Is 
permitted.  RS  command  is  always  valid.  Operator  Input  is  shown  below: 

RS 

5.4.4  Power-Up  Initialization  (IN)  Command 

Tnls  command  Is  equivalent  to  depression  of  the  front  panel 
Initiate  { IN IT )  pushbutton.  Commands  chained  beyond  IN  are  lost.  IN 
command  Is  always  valid.  Operator  Input  Is  shown  below: 
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5.4.5  Halt  Jobs  (HJ)  Command 

Tnis  command  is  used  to  halt  execution  of  all  PR  jobs.  Any 
job  currently  executing  (Dusy)  is  checkpointed.  Normal  operation  is 
suspended  and  the  PR  enters  the  PR  halted  (stand-alone)  mode  of 
operation.  Tnis  command  is  always  valid.  Operator  input  is  shown 
bel  ow: 


HJ 

5.4.6  Terminate  Jobs  T(J)  Command 

This  command  discards  all  jobs  by  clearing  the  system  job 
index  and  system  job  list  of  all  entries.  This  command  is  only  valid 
when  the  IPR  is  halted.  Operator  input  is  shown  below: 

TJ 

5.4.7  Execute  Jobs  (XJ)  Command 

This  command  initiates  normal  PR  operation.  All  idle  or 
halted  jobs  are  called.  Tnis  command  is  valid  only  when  the  PR  is 
nalted.  Operator  input  is  shown  below: 

XJ 

Automatic  execution  of  this  command  is  indicated  by  the 
console  message  shown  below: 

AUTO-XJ 

5.4.8  Display  Jobs  (OJ)  Command 


This  command  is  used  to  display  the  state  of  an  operator 
selected  job  (or  CPU),  or  all  jobs.  It  is  used  automatically  to 
describe  a  job  or  CPU  halt  due  to  failure  or  trace  breakpoint.  Further, 
the  job  specified  by  the  operator  or  halted  job  defines  the  job  (or  CPU) 

referenced  in  other  commands.  The  commands  which  relate  to  a  specific 
job  are  DM,  AM,  DR,  AR,  arid  ST. 

The  three  operator  command  input  options  are  shown  below. 

Thesp  commands  are  always  valid. 

DJ 

DJ  job  name 
OJ  ALL 
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If  tne  job  name  is  omitted  the  currently  selected  job  is 
displayed.  The  one  to  five  character  name  specifies  the  desired  job. 
"ALL"  requests  the  display  of  all  resident  jobs  in  sequential  order. 
Additionally  the  ALL  option  displays  the  PR  ID  and  current  operational 
mode  as  shown  below: 

PR  I.D.  XXXX  HALTED 

PR  l.D.  XXXX 

Tne  job  or  halted  CPU  state  is  displayed  as  shown  below: 

JOB  job  name 

state  reason  CPU  n  ST:  XXXX  PC:  XXXX  WP:  XXXX 

The  "job  name"  defines  the  job  or  CPU.  The  CPU  name  (CPU  1, 
CPU  2,  etc.)  is  printed  instead  of  a  job  name  for  PR  halts  winch  may 
not  be  associated  with  a  system  job. 

Tne  "state"  describes  the  job's  current  execution  state,  as 

foil ows: 


BUSY  Job  busy  executing 

HALTED  dob  halted  due  to  hardware  failure,  job 

detected  failure  or  software  trace 
breakpoint 

SPNULD  Job  execution  suspended 

CKPTED  Job  execution  checkpointed 

IDLE  Job  has  nev  r  executed  or  has  been  re- 

i  nitial  ized 

The  "reason"  describes  why  a  job  is  halted,  as  follows: 


TIMER  FAULT 
BUS  TIMEOUT  FAULT 
IMV  OPC  FAULT 
PARiTY  FAULT 

trace  fault 

FAULT 


Watch  dog  timer  elapsed 

Bus  response  timeout 

Invalid  instruction  operation  code 

RAM  or  PROM  memory  parity  error 

Software  trace  breakpoint  trap 

Job  detected  fault  invoked  by 
"XOP  eXHALT.JBCTRL"  instruction 
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iNTR  FAULT  Invalid  (unused)  interrupt  fault 

CPU  n,  wnere  n  equals  1  ,  2,  3,  etc.,  identifies  tne  CPU  which 
is  executing  or  has  last  executed  the  job. 

XXXX  respectively  describes  the  current  contents  of  the  non- 
ousy  job  s  CPU  status  (ST),  program  counter  (PC),  and  workspace  pointer 
(WP)  registers.  The  PC  defines  the  address  of  the  next  instruction  to 
be  executed. 

XXXX  is  an  absolute  lo-bit  C^U  address  or  status  register 
value.  A  job's  zone  2  address  for  the  PC  and  WP  register  content  is 
displayed  as  XXXXR.  R  following  the  address  indicates  that  tne 
relocation  constant  has  been  subtracted  from  the  absolute  address  before 
display.  XXXXR  defines  the  job  address  as  it  appears  in  the 
source/object  program  listing  (see  use  of  XXXXR  address  specification  in 
Ai<1/ DM  commands). 

5.4.9  Display  Memory  or  Peripheral  I/O  (DM)  Command 

This  command  is  used  to  display  the  contents  of  selected  RAM, 
PROM,  or  peripheral  device  registers.  The  operator  may  display  single 
locations  or  a  series  of  locations  between  specific  address  limits.  The 
operator  may  specify  the  addresses  of  locations  to  be  displayed  as  a  20- 
bit  absolute  bus  address,  as  a  lb-bit  absolute  bus  address,  or  as  a  16- 
bit  CPU  byte  address  relocated  to  a  specific  job’s  zone  2  address  space. 
Example  of  the  operator  input  options  and  resulting  display  are  shown 
oelow.  These  commands  are  always  valid.  Operator  input  is  underlined. 

DM  F000 

F000  AAA A 

DM  El  24  El  2d 

El  24  0431  C006  072C 

DM  400R 

0410  0000 

DM  OW  8W 

"TFOOOO  0100  B67E  0100  B686  0100  367E  0080  B6EC 

The  first  example  illustrates  the  display  of  a  single  absolute 
16-bit  CPU  byte  address  FOOC^g.  The  second  example  illustrates  the 
display  of  a  series  of  locations  E124ieco  E128,6.  The  third  example 
illustrates  use  of  the  absolute  16-bit  CPU  byte  address  relocated  in 
7one  2.  The  character  R  immediately  following  the  address  specifies 
tnis  option.  This  option  allows  the  operator  to  input  an  address  from 
tne  job  source/object  listing  and  have  it  relocated  to  its  absolute 
value  in  zone  2.  The  last  example  illustrates  use  of  the  absolute  20- 
bit  bus  address  option. 
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Leading  zeros  in  all  addresses  may  be  omitted.  Mixed  address 
formats  in  a  single  command  are  not  permitted.  The  16-bit  CPU  addresses 
are  incremented  by  2,  while  20-bit  absolute  addresses  are  incremented  by 
1  for  each  consecutive  location. 

6.4.10  Alter  Memory  or  Peripheral  I/O  (AM)  Command 

Tnis  command  is  used  to  alter  (modify)  the  contents  of 
selected  RAM  memory  or  peripheral  device  interface  registers.  The 
operator  may  modify  single  locations  or  a  series  of  locations  beginning 
at  a  selected  aadress.  Locations  in  a  series  may  be  selectively 
skipped.  As  in  the  DM  commands,  the  selected  address  may  be  an  absolute 
or  relocated  16-Dit  CPU  byte  address,  or  an  absolute  20-bit  bus  address. 
The  operator  input  options  are  illustrated  below.  These  commands  are 
always  valid. 

AM  F000  1  23 

AM  F000  1 234  S  45o7 

AM  300R  460  31  OR 

AM  F0001  W  AbCU 

Line  1  modifies  absolute  16-bit  CPU  address  F000  to  contain 
Q1  ^16 •  ^  data  input  is  right  justified  in  one  16-bit  word.  Line  2 

modifies  locations  F  000]  6  and  F004,  6  to  contain  1  234,  h  and  4567, 
respectively.  The  character  "S"  causes,  in  this  case,  location 
to  be  skipped. 

Line  3  modifies  two  locations,  300i  5  and  302, 5,  relocated  to 
the  selected  jod  s  zone  2  address  space.  The  data  0310,(5  will  be 
modified  by  the  value  of  the  job's  zone  2  relocation  displacement.  Line 
4  modifies  absolute  bus  location  F0001-|g  to  contain  ABCDj  5. 

Data  operands  or  skip  location  characters  are  delimited  by  one 
or  more  space  characters.  Input  is  limited  to  a  single  console  line. 
Leading  zeros  in  address  or  data  operands  may  be  omitted.  Consecutive 
data  operands  modify  consecutive  locations  from  the  selected  start 
address.  A  16-bit  CPU  byte  address  increments  by  2,  a  20-bit  bus 
address  increments  by  1  to  address  the  next  consecutive  location. 

5.4.11  Display  Job  Registers  (DR)  Command 


This  command  is  used  to  display  the  contents  of  a  selected 
job  s  registeis:  status  (ST),  program  counter  (PC),  workspace  pointer 
(WP),  or  workspace  registers  (RO-RF)  defined  by  the  workspace  pointer. 
A  specific  job  is  selected  by  the  Display  Job  (DJ)  command.  The 

operator  input  options  are  shown  below.  These  commands  are  always 
valid. 
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UR  3T 
OR  PC 
OR  WP 
DR  Rn-j 
DR  Rn]Rri^ 

The  numbers  n-j  ,  and  no  are  hexadecimal  numbers,  i.e.,  0-9  or 

A-F. 

Lines  1  ,  2,  and  3  illustrate  the  operator  input  to  display 
respectively  the  selected  non-busy  job's  ST,  PC,  and  WP  registers.  The 
display  via  printed  messages  is  identical  to  the  Display  Memory  (DM) 
command  display  where  the  first  column  displays  the  address  and  the 
second  column  the  contents  of  the  selected  register. 

Lines  4  and  5  illustrate  respectively  the  operator  input  to 
display  the  contents  of  a  single  workspace  register  or  a  consecutive 
series  of  registers  Rn-j  through  Rng.  As  above,  the  display  via  printed 
messages  is  identical  to  the  Display  Memory  (DM)  command  display. 

5.4.12  Alter  Job  Registers  (AR)  Command 

This  command  is  used  to  alter  (modify)  the  current  the  current 
contents  of  a  selected  job's  registers:  status  (ST),  program  counter 
(PC),  workspace  pointer  (WP),  or  workspace  registers.  A  specific  job  is 
selected  by  the  Display  Job  (DJ)  command.  The  operator  input  options 
are  shown  below.  Tnese  commands  are  valid  only  when  the  PR  is  halted. 

AR  ST  F 

AR  PC  JOUR 

AR  WP  0200 

AR  Rn  FI  23 

AR  Rn  1234  5678 

The  number  n  is  a  hexadecimal  digit,  i.e.,  0-9  or  A-F. 

Lines  1  ,  2,  and  3  illustrate  the  operator  input  to  modify 
respectively  the  contents  of  the  ST,  PC,  and  WP  registers  to  contain 
000F-15,  030U|  5  plus  job  relocation  displacement,  and  0200-j  5.  A  single 
register  may  be  modified  per  operator  command.  Line  4  illustrates  the 
operator  input  to  modify  a  single  workspace  register.  Line  5 
iTustrates  the  operator  input  to  modify  a  series  of  consecutive 
workspace  registers,  beginning  at  the  specified  register.  Data  input 
formats  are  identical  to  data  input  for  the  Alter  Memory  (AM)  command. 
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5.4.13  Set  Trace  Breakpoint  (ST)  Command 

This  command  Is  used  to  select  one  to  six  software  Instruction 
trace  breakpoints.  The  operator  Input  Is  shown  below.  These  commands 
are  valid  only  when  the  PR  Is  halted. 

ST  El  00 

ST  300R  31  OR  31 4R  SOOR  504R  50CR 

ST  S  320R  0 

Line  1  Illustrates  the  operator  Input  to  define  the  first 
trace  breakpoint  at  location  El 00i g.  A  previously  defined  first  trace 
breakpoint  Is  discarded.  The  remaining  five  breakpoints  are  unchanged. 
Line  2  Illustrates  selection  of  all  six  trace  breakpoints.  All 
breakpoints,  In  this  case,  are  relocated  to  the  selected  job's  zone  2 
address  space,  the  job  Is  selected  by  the  Display  Job  (DJ)  command. 

Line  3  Illustrates  the  operator  input  which  skips  the  first  breakpoint 
(breakpoint  remains  as  previously  defined),  defines  the  second 
breakpoint,  and  clears  the  third  breakpoint.  All  breakpoints  may  be 
cleared  by  use  of  the  Clear  Trace  (CT)  command. 

Guidelines  for  selection  of  trace  breakpoints  are  listed 

bel  ow: 

■  i 

1 .  Trace  breakpoints  for  more  than  one  job  may  be 
concurrently  defined.  Previously  selected  breakpoints  may 
be  cleared  or  redefined  regardless  of  previous  job 
selection. 

2.  Trace  breakpoint  word  aligned  addresses  must  define  the 
first  word  of  multiword  length  Instructions.  They  must 
define  an  Instruction  (not  data)  address. 

3.  Multiple  trace  breakpoints  must  not  define  the  same 
address. 

4.  Trace  breakpoints  may  be  selected  in  reiterative  program 
sequences  as  long  as  continuation  address  Is  Included. 
Trace  continuation  Is  described  below. 

o.  The  20-dI t  bus  address  (W)  form  may  not  be  used  to  define 
trace  breakpoints. 

The  SET  Trace  (ST)  command  Inserts  breakpoints.  The 
Instruction  at  the  selected  address  is  saved  and  replaced  by  an 
"XQP  RO.TBPT"  (2C8Q-16)  Instruction.  Job  execution  Is  Initiated  with  the 
XJ  command.  Execution  continues  normally  until  a  trace  breakpoint  is 
encountered. 
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Upon  execution  of  tne  breakpoint  instruction,  the  operating 
system  captures  the  machine  state  of  the  trace  halted  job,  halts 
execution  of  all  other  jobs,  and  calls  the  Operator  Control /Monitor 
(uebug)  job  wriich  displays  the  state  of  the  trace  hal  tea  job  as  shown  in 
Section  o.4.8.  Other  debug  job  commands  may  be  used  to  further 
investigate  the  state  of  the  PR  at  the  trace  breakpoint. 

Software  execution  may  be  continued  from  the  trace  breakpoint 
location  by  use  of  the  Execute  Jobs  (XJ)  command.  When  the  job  initiate 
address  (current  PC)  equals  a  selected  breakpoint,  a  continuation 
breakpoint  is  created  at  the  next  instruction  location  from  the 
breakpoint  if  this  location  is  not  also  a  selected  breakpoint.  The 
breakpoint  location  is  restored.  The  operating  system  regains  control 
via  the  continuation  breakpoint,  restores  the  continuation  location,  and 
inserts  the  breakpoint  instruction  at  the  original  breakpoint. 

Execution  is  then  continued  normally  from  the  continuation  breakpoint 
1 ocation. 

5.4.14  Clear  Trace  Breakpoint  (CT)  Command 

Tnis  command  is  used  to  clear  all  previously  selected  trace 
breakpoints.  Original  instructions  at  the  trace  breakpoints  are 
restored.  The  operator  input  is  shown  below. 

CT 

This  command  is  only  valid  when  the  PR  is  halted. 

5.4.15  Execute  Operator  Routine  (GO)  Command 

Tin's  command  specifies  an  entry  address  and  transfers  control 
to  an  operator  specified  routine.  Operator  input  is  shown  below.  This 
command  is  always  valid. 

GO  440R 

Only  absolute  or  relocated  15-bit  byte  address  entry  addresses 
are  permitted.  The  operator  routine,  typically  defined  by  an  AM 
command,  is  entered  at  the  specified  address.  The  routine  executes  as 
part  of  the  Debug  job. 


Only  registers  R0-R8  may  be  used  if  a  new  workspace  is  not 
defined  by  the  routine.  To  resume  normal  Debug  execution,  the  routine 
should  be  exited  with  a  "8  *R13"  (045Djg)  instruction. 

The  GO  command  is  intended  for  use  in  special  test/maintenance 
si tuations. 
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5.4.16  Console  Load  (LD )/Load  Verify  (LV)  Commands 

These  commands  are  used  to  load  (LD)  object  software  Into  the 
PR,  or  to  verify  the  correctness  of  previously  loaded  software  (LV). 

Operator  Input  Is  shown  below. 

LD 

LV 

These  commands  are  only  valid  when  the  PR  Is  halted.  If  a  new 
(version  of  an  existing)  job  Is  to  be  loaded,  the  "RS"  and  "TJ"  commands  must 
be  executed  before  the  "LD"  command  to  reset  the  OS  and  to  clear  the  System 
Job  List.  These  three  commands  can  be  chained,  as  shown  below;  If  the  IPR  Is 
strapped  for  auto-restart,  the  commands  must  be  chained. 

RS;TJ ;LD 

Load  object  Is  typically  contained  on  TI  Silent  700  terminal 
type  cassettes.  Load  object  In  Input  from  the  terminal  connected  to  the 
PR  I/O  channel.  After  operator  Input  of  the  LD  or  LV  command,  the 
operator  Is  instructed  to  start  data  Input  by  the  message  below. 

TURN  TAPE  ON 

To  Input  data  from  the  tape  cassette: 

1.  Insert  tape  cassette  in  terminal. 

2.  Set  Record/Playback  switch  to  playback. 

3.  Set  Playback  switch  to  LINE. 

4.  Set  Tape  Format  switch  to  LINE. 

5.  Depress  Rewind  followed  by  LOAD/FF  to  rewind  tape  and  set 
tape  to'load  point. 

6.  Depress  Playback  Control  CONT  START. 

If  an  error  Is  detected  during  the  load  the  error  message 
Illustrated  below  Is  printed. 

-ERROR  n  jobname  aaaa 

The  error  number  "n"  describes  the  failure  as  shown  below. 

Error  0  -  A  load  verification  of  a  relocatable  job  was 

requested,  but  the  job  did  not  exist  in  the  system 
job  list. 
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Error  1  -  A  relocatable  job  load  was  requested,  but  there  were 
no  empty  entries  In  the  system  job  list. 

Error  2  -  The  checksum  at  the  end  of  an  object  code  record 
does  not  match  the  checksum  calculated  while 
Inputting  the  record. 

Error  3  -  While  loading  a  program,  no  characters  were  received 
for  150  character  periods  during  console  load  or  no 
load  data  packets  were  received  for  15  load  request 
periods  (75  seconds)  during  down-line  load. 

Error  4  -  An  object  code  tag  not  supported  by  the  loader  was 
encountered. 

Error  5  -  A  job  checksum  error  was  detected  In  a  job,  or  a  bus 
time-out  or  memory  parity  error  was  detected  while 
generating  and  testing  the  checksum  of  the  load. 

Error  6  -  Load  verification  error.  The  data  word  from  tape 
did  not  equal  the  resident  word. 

Error  7  -  A  memory  parity  error  failure  was  detected. 

Error  8  -  A  bus  time-out  failure  was  detected. 

The  job  name  Is  printed  for  errors  detected  during  loading  of 
the  job.  The  hexadecimal  number  "aaaa"  is  a  16-bit  CPU  address.  For 
errors  6,  7,  and  8,  "aaaa"  defines  the  memory  address  In  error  or 
address  accessed  when  the  error  occurred. 

Upon  completion  of  the  load  (with  or  without  errors),  the 
message  below  Is  printed. 

-TURN  TAPE  OFF 

The  operator  should  stop  data  Input  by  depressing  the  STOP 
switch  opposite  the  CONT  START  position.  After  data  Input  has  ceased, 
the  message  below  Is  printed. 

-END 

The  message  resulting  from  an  error  free  load  or  load  verify 
Is  shown  below. 


-TURN  TAPE  ON-TURN  TAPE  OFF-END 

5.4.17  Down-Line  Load  (DL)/Load  Verify  (DV)  Commands 

These  commands  are  used  to  down-line  load  (DL),  or  down-line 
verify  (DV)  object  data  via  the  PR  radio  or  1822  Interface.  The 
commands  may  be  used  regardless  of  the  value  of  the  down-line  load 
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enable  hardware  switch.  The  commands  are  only  valid  when  the  PR  is 
halted.  The  operator  may  specify  the  name  of  the  load  data  file. 

Operator  input  is  shown  below. 

DL  jobname 

DV  jobname 

If  a  new  (version  of  an  existing)  job  is  to  be  loaded,  the  "RS"  and 
,J  commands  must  be  executed  before  the  "DL"  command  to  reset  the  OS  and  to 
clear  the  System  Job  List.  Those  three  commands  can  be  chained,  as  shown 
below;  if  the  IPR  is  strapped  for  auto-restart,  the  commands  must  be  chained. 


RS;TJ;DL  Jobname 

The  one  to  seven  character  jobname  if  specified  is  inserted  in 
the  load  request  ROP  packet.  If  omitted  any  load  object  file  will  be 
accepted  (file  name  in  load  request  ROP  is  ETX  only).  After  the  command 
input,  the  message  below  is  printed  on  the  I/O  channel  console  to 
indicate  initiation  of  the  load. 

DOWN-LIME  LOAD 

Errors  detected  during  loading  are  identified  via  console 
message  shown  below  as  described  in  Section  5.4.16. 

-ERROR  n  jobname  aaaa 

Completion  or  termination  due  to  error  of  the  down-line  load 
or  load  verify  is  indicated  by  the  console  message  below. 

-END 

The  console  message  for  an  error  free  load  or  load  verify  is 
shown  below.  J 


DOWN-LINE  LOAD-END 
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